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PREFACE 



This publication describes the MFT 
Supervisor, its relationship to the rest of 
the control program , and the interaction of 
its modules. The information in this pub- 
lication is intended for personnel who are 
responsible for determining sources of 
errors within or making modifications to 
the MFT Supervisor. 

The MFT Supervisor PLM is comprised of 
the following six sections: "Section 1. 
Introduction" describes the relationship of 
the supervisor to the other parts of the 
control program, its general characteris- 
tics, and its optional special features. 
"Section 2. Method of Operation" provides 
an overview of the services provided by the 
supervisor. "Section 3. Program Organiza- 
tion" describes in text and flowcharts the 
logical processing of each module in the 
supervisor and provides a synopsis of each 
module (module name, CSECT name, flowchart 
cross-reference, entry points, exits, other 
modules used, tables and work areas). 
"Section 4. Module Directory" cross- 
references entry points, module names, and 
CSECT names. "Section 5. Data Areas" con- 
tains the formats of the control blocks, 
request blocks, and work areas used by the 
supervisor and describes the fields within 
each area. "Section 6. Diagnostic Aids" 
contains information that may be useful in 
determining the source of an error within 
the supervisor. 

The "Method of Operation" section and 
the module descriptions, module synopses, 
and flowcharts with the "Program Organiza- 
tion" section are organized by supervisor 
components. These components are, in order 
of presentation: 

• Interruption Supervision 

• Task Supervision 

• Task Termination 

• Contents Supervision 

• Main Storage Supervision 
© Communications Task 

• Timer Supervision 

• Overlay Supervision 

• Recording/Recovery Services 

• Checkpoint/Restart 

• Device Independent Display Operator 
Console Support 



• Special Features 



Because you may wish to refer to the 
same diagram for several separate text 
descriptions. Diagrams 1 through 21 are 
provided as foldouts and are located imme- 
diately after Section 6. 
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SECTION 1: 



INTRODUCTION 



This section describes the purpose and 
function of the MFT Supervisor , its rela- 
tionship to the control program, its opera- 
tional environment, and its physical 
characteristics . 



THE RELATIONSHIP OF THE MFT SUPERVISOR TO 
THE CONTROL PROGRAM 

The MFT Supervisor is one part of the 
control program with MFT. The MFT Supervi- 
sor (referred to as "the supervisor") mon- 
itors each unit of work to be done in the 
operating system. Two additional parts of 
the operating system are job management, 
which accepts and schedules jobs in a con- 
tinuous flow, and data management, which 
stores, maintains, and retrieves all data. 
Figure 1 illustrates how task management 
(the supervisor) works in conjunction with 
data and job management to process a 
program . 

For additional information about the 
control program with MFT, refer to Job 
Management with MFT . 



PURPOSE AND FUNCTION OF THE MFT SUPERVISOR 

Job steps (tasks within the operating 
system) are executed under the control of 
the supervisor, which allocates needed 
resources on the basis of priorities. The 
supervisor assigns the resources to perform 
tasks, keeps track of all such assignments, 
and ensures that the resources are freed 
upon task completion. If one resource is 
needed by several tasks, queuing of 
requests may be required. The supervisor 
thus maintains control of resources that 
can be shared. This enables more efficient 
use of the central processing unit, main 
storage, system and user programs, and the 
interval timer. 

The activity of the supervisor may be 
divided into two major areas: Interruption 
Supervision and Resource Handling. 

Interruption Supervision 

Supervisor activity generally begins 
with an interruption. In IBM System/360 
and System/370, the interruption is a 
machine characteristic. It is the means by 
which the supervisor gains control of the 
central processing unit to provide 
resources and services for the performance 
of a task. 



There are five types of interruptions: 

• Supervisor call (SVC) interruption: a 
request for a particular supervisor 
service. 

• Timer/external interruption: an atten- 
tion signal from the interval timer, 
the console interruption key, or the 
direct control feature. 

• Input/output interruption: a signal 
that an input/output event has occurred 

o Program interruption: a signal that a 
program has attempted an invalid action 

• Machine-check interruption: a signal 
that a machine error has occurred. 

An interruption-handling program of the 
supervisor analyzes each interruption using 
control information available to it at the 
time of the interruption. Each of the five 
interruption types has associated with it 
two program status words (PSWs) . The Old 
PSW contains the information needed by the 
supervisor to analyze the interruption. 
The New PSW contains the address of the 
appropriate interruption-handling routine. 

When an interruption occurs, the CPU 
stores the contents of the current PSW in 
the Old PSW for that type of interruption 
and loads the New PSW. By loading the New 
PSW, the CPU places itself in supervisor 
state and passes control to the 
interruption-handling portion of the super- 
visor. The supervisor then passes control 
to those parts of the control program that 
handle the resources needed to service the 
interruption . 

The exiting and dispatching routines of 
interruption supervision return control 
from an interruption- handling routine to 
the interrupted program. The exiting rou- 
tines determine what type of program has 
completed execution and perform the clean- 
up operations (such as resetting control 
tables) before control is returned to the 
caller. The dispatching procedure is used 
to return control to the ready task with 
the highest priority. 

Resource Handling 

Figure 2 illustrates how the 
interruption-handling portion of the super- 
visor interacts with the resource-handling 
portion to service an interruption. The 
resource-handling portion of the supervisor 
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JOB MANAGEMENT 




• Read/Interpret Job Stream 

• Enters Control Statements on Input Work Queue 

• Writes Dota to Input Data Set 

• Initiates Task A 

• Allocates I/O Devices to Task A 



TASK MANAGEMENT 
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• Brings Task A into Main Storage 

• Allocates Resources to Task A 
by Priority 
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• Interprets Task A's Request 

• Routes Request to Data Management 

• Returns to Task A 
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• Reads Data from Input Data Set 

• Writes Data to Output Data Set 



JOB MANAGEMENT 



• Releases I/O Devices 

• Writes Control Statements 
for Output Data 

• Writes Output Data 
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• Releases Resources of Task A 

• Terminates Task A 
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is comprised of system programs that may be 
grouped into the following functional 
catagories : 

« Task Supervision . If the subtasking 
option was selected, the supervisor 
creates a task in response to a request 
to attach a subtask to an already 
existing task. The order in which 
tasks gain control of system resources 
(priority) is also affected by task 
supervision whether or not the system 
has subtasking. 

© Task Termination . The supervisor pro- 
cesses the normal and abnormal termina- 
tion of tasks. 

• Contents Supervision . The supervisor 
keeps records of and provides linkage 
between all programs in main storage. 
Contents supervision also brings 
requested programs into main storage 
through linkage with Data Management. 

• Main Storage Supervision . The supervi- 
sor assigns and releases main storage 
needed to perform tasks. 



• Communications Task . The supervisor 
allows the operator to communicate 
directly with the system and a program 
to write a console message to the 
operator. 

® Timer Supervision . The supervisor con- 
trols the use of the System/360 inter- 
val timer and the System/370 time-of- 
day clock. 

• Recovery Management . The recovery 
management routines, which are option- 
al, record information about a machine 
malfunction. The Machine-Check Handler 
records environmental data and attempts 
to analyze the malfunction and restore 
the system to normal operation. 

• Checkpoint/Restart . On request, the 
supervisor writes records of a task f s 
main storage along with control infor- 
mation so that the task can be 
restarted from that point at a later 
time. 

After a control program service has been 
performed, the supervisor determines what 
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task is to be performed next f as seen in 
Figure 2. 



TRACING FACILITIES 

Two facilities , the Trace Table and the 
Generalized Trace Facility (GTF) , are pro- 
vided to assist in tracing program flow by 
monitoring and recording system events. 

Trace Table 

The Trace Table facility is an optional 
feature specified during system generation. 
The Trace Table routines place entries , 
each of which is associated with a certain 
type of event, in a trace table. The size 
of the table is also a system generation 
option; when the table is filled, the rou- 
tine overlays old entries with new entries 
beginning at the top of the table. Trace 
table entries are formatted and printed out 
on SNAP dumps and stand-alone dumps. 



Generalized Trace Facility 

The Generalized Trace Facility (GTF) is 
initiated by the operator using the START 
command and executes as a problem program 
in its own partition. When GTF is started, 
the operator selects specific events to be 
traced and may select to record the trace 
data either in main storage or on an 
external device. When the internal storage 
option is selected, the recorded data is 
comparable to that provided by the optional 
Trace Table. When the external device 
storage option is selected, the recorded 
data is more comprehensive. When GTF is 
active, the optional Trace Table facility, 
if present, is disabled. If the trace 
records are maintained in main storage and, 
a SYSABEND DD statement is included, ABDUMP 
provides formatted trace data for abnormal- 
ly terminated users. When trace records 
are stored on an external device, a trace 
EDIT function of IMDPRDMP will provide the 
output of selected data. 



SPECIAL FEATURES 

The following facilities are optional 
features of the supervisor that do not fall 
within the general functional areas of the 
supervisor . 

Time Slicing 

When the system is generated, the user 
selects a group of contiguous partitions 
for time-slicing. The dispatching and 
exiting portions of the supervisor recog- 
nize the dispatching priorities assigned to 
the time- slice group through a queue of 



time-sliced tasks. Time-slicing occurs 
only among the tasks in the group and only 
when the priority level of the group is 
dispatched for the specified time slice. 
The dispatching of tasks within the group 
continues until all the tasks are waiting, 
or a task with a higher priority than that 
of the group becomes ready. If the system 
has the subtasking option, tasks may be 
added to or removed from the time- slice 
group by changing the dispatching priori- 
ties of the tasks. 



Main Storage Hierarchy Support 

Main storage may be expanded by includ- 
ing IBM 2361 Core Storage in the system. 
Main Storage Hierarchy Support for IBM 
2361, Models 1 and 2, is a control program 
option that permits selective access to 
either the processor storage (hierarchy 0) 
or 2361 Core Storage (hierarchy 1) . 

Extended Precision Floating-Point Decimal 
Simulator 

This option allows all System/360 and 
System/370 CPUs that do not support or only 
partially support the extended precision 
floating-point instructions to simulate 
hardware processing when one of these eight 
instructions is encountered. The modules 
that support this function are accessed 
when one of these instructions causes a 
program check and is processed by an exit 
routine specified in a SPIE macro 
instruction. 

System Management Facilities 

System Management Facilities (SMF) is an 
optional feature of the control program 
which can be selected at system generation. 
It gathers and records information used to 
evaluate system usage. SMF functions are 
performed by both job management and super- 
visor routines. 

Shared Direct Access Device 

The Shared Direct Access Device (Shared 
DASD) feature enables independently operat- 
ing data processing systems to share direct 
access storage devices. The two- channel 
switch and its control commands, device 
reserve and device release , control sharing 
of direct access storage between systems. 
The shared DASD feature provides the con- 
trol program functions needed to control 
device reservation and release. 



OPERATING ENVIRONMENT 

In an operating system with MFT, main 
storage is divided in two major areas: the 
fixed area and the dynamic area. The fixed 
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Figure 3. Main Storage during Execution 



area and the dynamic area are subdivided as 
shown in Figure 3. The fixed area, located 
in the lower portion of main storage, con- 
tains the resident portion of the supervi- 
sor, and control blocks and tables used by 
the system. The size of the fixed area 
depends on the number of partitions estab- 
lished by the user and the supervisor 
options selected during system generation. 
The dynamic area, located in the upper por- 
tion of main storage, is divided into par- 
titions. Each partition may be occupied by 
one or more processing programs, or by job, 
task, and data management routines when 
performing a service for a user task. 



Fixed Area 

In MFT, the fixed area is that part of 
main storage into which the nucleus is 
loaded at IPL. The storage protection key 
of the fixed area is so that its contents 
can be modified only by the supervisor. 
The fixed area also contains the partitions 
for the communications task, the master 
scheduler task, and the two transient areas 
into which certain nonresident routines are 
loaded when needed: the SVC transient area 
(102U bytes) and the I/O supervisor tran- 
sient area (1024 bytes). Each transient 
area contains only one routine at a time. 
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When a nonresident SVC or error- handling 
routine is required, it is read into the 
appropriate transient area. The transient 
routines operate with a protection key of 
0, as do other routines in the fixed area. 

System Queue Area 

The system queue area (SQA) is estab- 
lished by the Nucleus Initialization Pro- 
gram in the fixed area and provides the 
main storage required for WTOR emergency 
buffers, subtask TCBs, queue control 
blocks , and queue elements built by the 
control program. The SQA must be at least 
1600 bytes for a minimum two- partition sys- 
tem. Its storage protection key is so 
that it can be modified by control program 
routines only. 

Dynamic Area 

Figure 3 also shows how the contents of 
each partition in the dynamic area are 
organized and how they are related to the 
rest of main storage. Job management rou- 
tines , processing programs, and routines 
brought into storage by a LINK, ATTACH, or 
XCTL macro instruction, are loaded at the 
lowest available address. The highest por- 
tion of the partition is occupied by the 
user's parameter area and user's save area. 
The next portion of the partition is occu- 
pied by the task input/output table (TIOT) , 
which is built by job management. This 
table is used by data management routines 
and contains information about DD 
statements. 

Each partition may be used for a problem 
program as well as for system tasks. When 
the supervisor requires main storage to 
build control blocks or work areas, it 
obtains this space from the partition of 
the processing program that requested the 
space. Access method routines and routines 
brought into storage by a LOAD macro 
instruction are placed in the highest 
available locations below the task input/ 
output table. 

Resident Portion of the Supervisor 

The resident portion (nucleus) of the 
supervisor resides in SYS1. NUCLEUS. It is 
made up of those routines, control blocks, 
and tables that are brought into main 
storage at initial program loading (IPL) 
and are never overlaid by another part of 
the operating system. The nucleus is 
loaded into the fixed area of main storage. 

The resident task management routines 
include all of the routines that perform: 

• Interruption supervision 

• Main storage supervision 



They also include portions of the routines 
that perform: 

• Task supervision 

• Contents supervision 

• Timer supervision 

• Overlay supervision 

The resident job management routines 
include several of the communications task 
routines. The MFT communications task is 
described in this publication. 

The resident data management routines 
are the input/output supervisor and, 
optionally, the BLDL routines of the parti- 
tioned access method. These routines are 
described in the Input /Output Supervisor 
PLM, and the Sequential Access Method PLM . 

The user may also select resident reent- 
erable routines, which are access method 
routines from SYS1.SVCLIB, and other reent- 
erable routines from SYS1.LINKLIB. At sys- 
tem generation, the user specifies that he 
wants such routines resident. At IPL, he 
identifies the specific routines desired in 
the RAM= and RSVC= entries. The selected 
routines are loaded during system initiali- 
zation and reside adjacent to the higher 
end of the system queue area unless the 
BLDL table is also resident (see Figure 3). 

Types 3 and 4 SVC routines can also be 
made resident through the RSVC option. NIP 
loads these routines adjacent to the higher 
end of the resident reenterable routines. 
If there is no resident BLDL table or resi- 
dent reenterable routines, the routines are 
loaded adjacent to the higher end of the 
system queue area. 



Nonresident Portion of the Supervisor 

The nonresident portion of the control 
program comprises routines that are loaded 
into main storage as they are needed and 
can be overlaid after their completion. 
The nonresident routines operate in the 
partitions and in two sections of the nuc- 
leus called transient areas. 



Expanding the Size of Main Storage 

Main storage may be expanded by includ- 
ing IBM 2361 Core Storage (core storage) 
units in the system. Main Storage Hierar- 
chy Support for IBM 2361 Models 1 and 2 
permits access to either processor storage 
(hierarchy 0) or core storage (hierarchy 
1) . Each partition established during sys- 
tem generation is described by a boundary 
box (see Figure 4) . The first half of the 




Partition 
Hierarchy 1 



Partition 2 
Hierarchy 1 



Note: 

Partitions and 2 have been extended 
during system generation to include main 
storage in the 2361 Storage Unit. The 
extended storage is addressable by the CPU. 
The two physical partitions are logically 
one area of main storage to the Supervisor. 



(Hierarchy 1) 
2361 Storage Unit 

Figure 4. Main Storage with Hierarchy Support 



boundary box describes the processor 
storage partition, and the second half 
describes the core storage partition. 
Pointers in the boundary box for an unas- 
signed partition are set to 0. If a parti- 
tion is established entirely within hierar- 
chy 1, the processor storage pointers in 
the first half of the partition's boundary 
box are set to 0. If a partition segment 
is not generated in core storage, the core 
storage pointers in the second half of the 
partition's boundary box are set to 0. If 
core storage has been included in the sys- 
tem, but is offline, the second half of the 
boundary box will contain 0's. If core 
storage is excluded from the system, the 
second half of the boundary box is not 
generated. 



LOGICAL CHARACTERISTICS 

Each task in the system is represented 
by a task control block (TCB) . The TCB 
contains control information related to the 
task and pointers to system resources 
assigned to perform the task. 

When the operating system is generated, 
TCBs are built in the nucleus for each par- 
tition and for each system task (see Figure 
5). The system tasks are: the master 
scheduler task of job management, the com- 
munications task, and the transient area 
loading task. If specified, TCBs are also 
created for the following optional system 
tasks: the system error task, the Multiple 
Console Support (MCS) write-to-log task. 
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Figure 5. System Task Control Blocks 



the I/O Recovery Management Support task 
(I/O RMS), and the System Management Faci- 
lity task (SMF) . If the subtasking option 
is selected during system generation , addi- 
tional task control blocks may be con- 
structed by the supervisor Attach routine 
in the system queue area, whenever a user 
program requests the creation of subtasks. 

All the TCBs in the system are chained 
together according to dispatching priority 
to form the TCB queue. The relative dis- 
patching priority of system tasks and prob- 
lem program tasks is established when the 
system is generated. The system tasks are 
assigned higher dispatching priorities than 
the problem program tasks. The problem 
program tasks are assigned priorities 
directly corresponding to the location of 
the partition in main storage. Partition 
0, located at the highest address of main 
storage is assigned the highest priority, 
while partition n, located at the lowest 
address, is assigned the lowest priority. 
Figure 6 shows the relationship of a TCB 
and boundary box to a partition, and Figure 
7 illustrates the dispatching queue estab- 
lished during system generation. 



SUMMARY 

The MFT supervisor comprises those resi- 
dent and nonresident modules that receive 
and service interruptions. These services 
include supervisor-assisted linkage between 
modules, management of main storage and 
transient areas, priority dispatching of 
ready tasks, and normal and abnormal ter- 



mination of tasks. The supervisor modules 
are described in this publication by func- 
tional area as shown in Diagram 1. 
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SECTION 2: METHOD OF OPERATION 



This section describes the operation of 
the iYiFT Supervisor. Emphasis is placed on 
describing how the functional units and 
data areas interact in servicing requests. 
Cross-references to Section 3, "Program 
Organization, " relate the logic descrip- 
tions in this section to the physical 
descriptions, flowcharts r and tables con- 
tained there. Operation diagrams in Sec- 
tion 3 illustrate the flow of control and 
transmission of data. 



INTERRUPTION SUPERVISION 



Interruption supervision provides ini- 
tial processing of all interruptions; that 
is r control passes from the interrupted 
program to the interruption supervision 
routines and, in turn, to any additional 
routines needed to complete this processing 
(see Diagram 2). The interruption supervi- 
sion routines: 

© Save the interrupted environment so 
that it can be restored before return- 
ing control to the interrupted program. 

o Isolate interruptions from each other. 

© Pass control to routines that service 
the interruption. 

© Return control to the interrupted pro- 
gram or to the highest priority ready 
task when servicing is complete. 



PASSING CONTROL TO THE INTERRUPTION 
HANDLING PORTION OF THE SUPERVISOR 

The program status word (PSW) contains 
information required for proper program 
execution. The current PSW, which is main- 
tained by system hardware, always contains 
the address of the next instruction to be 
executed. (For a detailed description of 
the program status word, see Principles of 
Operation . ) There are two permanent PSW 
areas in main storage for each of the five 
types of interruptions (see "Types of 
Interruptions" below). Each New PSW is set 
by the Nucleus Initialization Program to 
point to the first- level interruption 
handler for that type of interruption. 
Each Old PSW is used as a save area for the 
current PSW when that particular type of 
interruption occurs. This save area will 
contain the address of the next sequential 
instruction that would have been executed 
if that type of interruption had not 
occurred. Thus, when an interruption occurs: 



The current PSW is saved in the Old 
PSW area associated with that type of 
interruption. The address in the PSW 
may be used to return control to the 
interrupted program. 

The New PSW associated with that type 
of interruption is loaded from its 
main-storage location and becomes the 
current PSW. This New PSW contains 
the address of the interruption hand- 
ling routine that services this type 
of interruption. 



TYPES OF INTERRUPTIONS 

There are five types of interruptions: 

• Supervisor Call (SVC) 

• Timer /External (T/E) 

• Input/Output (I/O) 

• Program Check 

© Machine Check 

There is one important difference 
between supervisor call (SVC) interruptions 
and the other four types of interruptions. 
An SVC interruption occurs when a problem 
program or system task requests supervisor 
services by using an SVC instruction or by 
using a macro instruction that expands to 
include an SVC instruction. Thus, an SVC 
interruption is a planned interruption, as 
opposed to the other four types which are 
unplanned (asynchronous) . 



SUPERVISOR CALL (SVC) ROUTINES 

Interruption supervision provides all 
interface operations associated with the 
four types of SVC routines: 

• Type 1 SVC routines : These routines 
are always resident and are executed 
disabled. They usually return control 
to the interrupted program without en- 
tering the Dispatcher. A type 1 SVC 
routine cannot use another SVC routine 
(except by a branch entry to a resident 
routine) because other type SVC rou- 
tines operate either partially or fully 
enabled. Examples of a type 1 routine 
are GETMAIN, FREEMAIN, EXCP, WAIT and 
EXIT. 
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Note ; A Type-1 SVC, write-to- 
Programmer interface facility is pro- 
vided to issue WTP messages for Type-1 
SVC routines during abnormal termina- 
tion processing (see Abnormal Termina- 
tion in Section II). 

Type 2 SVC routines : These routines 
are also resident; but they are par- 
tially enabled, or call other than type 
1 SVC routines. Examples are LINK, 
LOAD, and XCTL. 

Type 3 SVC routines ; These routines 
are like type 2 routines except that 
they are not resident (these may be 
made resident; see "Resident Type 3 and 
4 SVC Routine Option" below) . They are 
each brought into the 10 24- byte tran- 
sient area by Program Fetch. Examples 
are IDENTIFY and WTO. 

Type 4 SVC routines : These are "multi- 
phase" type 3 routines. They are too 
large to be brought into the transient 
area in one package, and therefore must 
be loaded in phases, each one overlay- 
ing a preceding one. Transfer of con- 
trol between phases is through XCTL. 
Examples are OPEN, CLOSE, and ABEND. 



EXIT — Provides return linkage from 
a Type 2, 3, or 4 SVC routine to the 
interrupted program or to the 
Dispatcher. 

• Timer/ External Interruption Routine 

T/E FLIH — Prepares for and passes 
control to the Job Management Extern- 
al Interruption Handler or the Timer 
Second-Level Interruption Handler. 

• Input/Output Interruption Routine 

I/O FLIH — Prepares for and passes 
control to the I/O Supervisor to pro- 
cess the interruption. 

• Program Check Interruption Routine 

Program Check FLIH — Prepares for 
and passes control to a user-supplied 
program interruption routine, or to 
ABTERM to schedule abnormal termina- 
tion of the interrupted routine. 

• Common Routines 

Validity Check routine — Provides 
address validity checking for other 
supervisor routines. 

Dispatcher — Provides return linkage 
from supervisor routines to the high- 
est priority task in the system that 
is ready to begin or resume execution 



INTERRUPTION SUPERVISION ROUTINES 

Except for a machine- check interruption, 
each interruption causes control to be 
passed to a first- level interruption handl- 
er (FLIH) which prepares for additional 
processing by other supervisor or user- 
supplied routines. A machine check inter- 
ruption causes control to be passed direct- 
ly to a machine recording or recovery rou- 
tine. The linkage is similar to that used 
to access the FLIH routines in that the 
machine check New PSW contains the address 
of the recording or recovery routine that 
is to process the interruption. Following 
is a summary of the routines that handle 
the other 4 types of interruptions. For a 
more detailed description of each routine, 
see Section 3: Program Organization. 

• Supervisor Call (SVC) Interruption 
Routines 

SVC FLIH — For a Type 1 SVC request, 
passes control to the appropriate 
service routine. For a Type 2, 3, or 
4 request, it passes control to the 
SVC second- level interruption handler 
(SLIH) for further processing. 
SVC SLIH — Monitors the SVC tran- 
sient area and prepares for Type 2, 
3, and 4 requests. 

Type 1 SVC Exit — Provides return 
linkage from a Type 1 SVC routine to 
the interrupted program or to the 
Dispatcher. 



SVC CONTROL INFORMATION 

The supervisor maintains SVC control 
information in the SVC Table and the Relo- 
cation Table. These tables are in module 
IEASVC00, which is assembled at system 
generation. 

The Relocation Table (see Figure 8) is 
used to relate the SVC code number to its 
corresponding entry in the SVC table. The 
table consists of a number of 1-byte 
entries, each of which is addressed using 
the SVC code number as an index. If the 
entry is 0, the corresponding SVC code is 
invalid. If the entry is not 0, the number 
in the entry is an index to an entry in the 
SVC Table. The first section of the Relo- 
cation Table contains entries for IBM codes 
(codes assigned to IBM-provided SVC rou- 
tines) . The second section contains 
entries for user codes (codes assigned to 
user-provided SVC routines). The initial 
entry in the table is for SVC and pro- 
gresses through the highest IBM code, 
whether or not it is in use in the system. 
The first user code in the second section 
is 255 and progresses toward the lowest 
user code. 

The SVC Table is also divided into two 
sections (see Figure 9). The first section 
contains a 3 -byte entry for each type 1 or 
type 2 SVC routine. The second section 
contains a 1-byte entry for each type 3 or 
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1 byte 



SVC 255 Index 



SVC n + 1 Index 



Each entry in this section 

corresponds to an IBM SVC 

code number, ranging from to highest. 



Value in each entry 
in both sections points 
to an SVC Table entry. 



Highest IBM Code 
255 



Each entry in this section 
corresponds to a user SVC code 
number, ranging from 255 to lowest. 



Lowest User Code 



Figure 8. SVC Relocation Table 



3 I 



3-byte entries for type 1 and 2 SVC routines 

Bits 

I 5 I 3 | 






ESA 



1-byte entries for type 3 and 4 SVC routines 

Figure 9. SVC Table Entries 

type 4 SVC routine. Each 3-byte entry con- 
tains a 24-bit main- storage address of an 
SVC routine. The three low- order bits of 
this address indicate the number of double- 
words required for the extended save area 
in the request block. These bits will be 
set to for a type 1 SVC. Each 1-byte 
entry in the table contains the doubleword 
length of the extended save area in the 
last three bits. 



The SVC Table may be extended during 
system generation so that each entry is 4 
bytes long. The 3-byte entries have the 
same format except that the address is pre- 
ceded by eight bits set to 0. Each 1-byte 
entry is replaced by track address (10 
bits), the record number (8 bits), the 
length of the first text record (11 bits), 
and the extended save area information (3 
bits) . The format of an extended SVC Table 
is shown in Figure 10. 



RESIDENT TYPE 3 AND 4 SVC -ROUTINE OPTION 

During system generation, the user may 
specify that certain type 3 and type 4 SVC 
routines be made resident so that frequent- 
ly used SVC routines need not be brought 
into the SVC transient area each time they 
are used (the Extended SVC Table Option 
must also be selected) . A resident type 3 
or type 4 SVC routine has the characteris- 
tics of a type 2 SVC routine. 

The following differences in operation 
result when the resident option and the 
Extended SVC Table option are selected dur- 
ing system generation: 

1. When the Nucleus Initialization Pro- 
gram makes a type 3 or 4 SVC routine 
resident, the routine's entry in the 
SVC Table is changed. The track 
address, record number, and length 
fields are overlaid by X f FF - and the 
entry point address of the routine. 
The X'FF" (a number larger than any 
track address) will indicate to the 
SVC FLIH that the entry is for a resi- 
dent type 3 or 4 SVC routine. 

2. The SVC entry procedure for a resident 
type 3 or 4 routine is similar to that 
for a type 2 routine. The use of 
FINCH and Program Fetch is not 
required because the routine is not 
loaded into the transient area. 

3. The SVC exiting procedure does not 
require the services of the transient 
area refresh subroutine (within the 
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ADDRESS 


ESA 


4-byte entries for type 1 and 2 SVC routines 

Bits 

1 10 | 8 1 11 1 3 1 


TT 


R 


Length 


ESA 



4-byte entries for type 3 and 4 SVC routines 

Figure 10. Extended SVC Table Entries 
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Dispatcher) if a resident type 3 or 4 
routine receives control since a resi- 
dent routine does not operate in the 
transient area and is not overlaid, 

4. The XCTL service routine checks the 
resident SVC load list created by the 
Nucleus Initialization Program to 
determine whether the SVC routine is 
resident or requires loading. 



PSEUDO-DISABLED INTERRUPTION SUPERVISION 

The I/O First-Level Interruption Handler 
CFLIH) contains a switch that is set by the 
contents supervision subroutine FINCH when 
main storage is not available during pro- 
cessing of a transient area request. In 
this case, a fixed work area called the 
PANIC is used to hold a parameter list 
passed to the data management BLDL and Pro- 
gram Fetch routines. This switch prevents 
other processing of requests from overlay- 
ing the PANIC. If pseudo-disabled, BLDL 
and Program Fetch use internal loops rather 
than issuing a WAIT macro instruction for 
I/O events. When the switch is set, the 
I/O and Timer/External FLIHs and the Type 1 
SVC Exit routine return control to the 
interrupted routine, rather than to the 
Dispatcher, to avoid a task switch. When 
FINCH processing is. complete, the pseudo- 
disable switch is cleared so that proces- 
sing for subsequent transient area requests 
can use the PANIC if necessary. 



INTERRUPTION SUPERVISION CONTROL FLOW 

The following paragraphs and Figures 13 
through 19 describe the processing within 
and the flow of control between the inter- 
ruption supervision routines that process 
supervisor call (SVC) , timer/external 
(T/E) , input/ output (I/O), and program 
check interruptions. For a description of 
the processing of machine checks, see 
"Recording/Recovery Routines." 



SUPERVISOR CALL INTERRUPTIONS 

When an SVC interruption occurs, the 
current PSW is stored in the SVC Old PSW, 
and the SVC New PSW becomes the current 
PSW, thereby giving control to the SVC 
First- Level Interruption Handler (FLIH) 
(see Diagram 3). If tracing facilities 
have been specified, the SVC FLIH uses the 
Trace Table routine (a system generation 
option), or, if active, the Generalized 
Trace Facility (GTF) routines to record the 
interrupt. The SVC FLIH then determines 
the type of SVC routine requested from the 
SVC code and the SVC table. For a type 1 
request, the SVC FLIH branches to the 
address indicated for the SVC routine in 



the SVC Table. Upon return from the type 1 
SVC routine, the SVC FLIH uses the type 1 
SVC Exit routine to provide linkage to the 
calling program (using the SVC Old PSW) or 
to the Dispatcher to determine which pro- 
gram is to receive control next. If the 
request is for a type 2, 3, or 4 SVC rou- 
tine, the SVC FLIH branches to the SVC 
Second-Level Interruption Handler (SLIH) 
for further processing. 

The SVC SLIH (see Diagram 4) obtains 
main storage and creates an SVRB for the 
requested routine. This SVRB is queued to 
the top of the RB queue on the TCB for the 
requesting program. If the request is for 
a nonresident type 3 or 4 SVC routine, the 
SVC SLIH uses FINCH and Program Fetch to 
bring the requested routine into the SVC 
transient area, and passes control to the 
requested routine. Upon return from the 
type 2, 3, or 4 SVC routine, the SVC SLIH 
branches to EXIT to provide return linkage 
to the appropriate routine. 

EXIT may be entered from the SVC SLIH, 
from a user-supplied error processing rou- 
tine, or from a terminating program that 
issued an SVC 3 (EXIT) instruction. The 
EXIT routine (see Diagram 5) returns con- 
trol to the interrupted program if a user- 
supplied error handling (SPIE) routine is 
exiting. If a user-supplied asynchronous 
exit routine (STAE) is exiting and there 
are more requests for the routine, EXIT 
returns control to the user-supplied rou- 
tine. If the request block for the exiting 
routine is not the last RB on the queue, 
EXIT dequeues the RB and uses FREEMAIN to 
release the RB and program area, and 
branches to the Dispatcher. If the RB is 
the last RB on the queue and the TCB is for 
a job step task, EXIT issues an SVC 13 
(ABEND) to normally terminate the task. 

In MFT with subtasking, if the RB for 
the exiting subtask is the last RB on the 
queue and the "task terminated" flag in the 
TCB is not set (this will be set by ABEND 
when only the SVRB for ABEND remains on the 
queue) , EXIT issues an SVC 13 for normal 
termination. If the "task terminated" flag 
is set indicating that the only RB on the 
queue is the SVRB for ABEND, the SVRB is 
freed, the end-of-task exit routine (if 
requested) is scheduled, and the TCB is 
removed from the queue. EXIT indicates 
that a task switch is necessary, branches 
to POST (if an ECB was specified) to post 
the ECB, and branches to the Dispatcher. 

The Validity Check Subroutine 

Supervisor routines use the Validity 
Check subroutine to check main storage 
addresses passed as input parameters by 
user programs. The Validity Check subrou- 
tine tests the following attributes of each 
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input address: fullword boundary alignment 
(optional) , whether the address lies within 
the boundaries of main storage, and whether 
the address specifies a storage area whose 
storage protection key matches the protec- 
tion key in the TCB of the calling main- 
line program. If any of the addresses is 
invalid the subroutine informs the invoking 
supervisor routine by altering the condi- 
tion code in the current PSW. Since the 
calling main- line program has made a 
serious error, the supervisor abnormally 
terminates the current task. Thus, the 
source of programming error is indicated at 
its point of occurrence, avoiding a program 
check during later processing. Such a pro- 
gram check might be difficult to diagnose. 
If it occurred during queue manipulation, 
the queues might be seriously disrupted, 
thus interfering with the performance of 
the other tasks. 



TIMER/EXTERNAL INTERRUPTIONS 

When a timer/ external (T/E) interruption 
occurs, the current PSW is stored in the 
External Old PSW, and the External New PSW 
becomes the current PSW, thereby giving 
control to the T/E First-Level Interruption 
Handler (FLIH) (see Diagram 6). If the 
Generalized Trace Facility (GTF) is active, 
the T/E FLIH uses the GTF routines to reco- 
rd the interruption. For an external 
interruption, control is passed to the Job 
Management External Interruption Handler 
(IEECVCRX) ; for a timer interruption, con- 
trol is passed to the Timer Second-Level 
Interruption Handler (IEA0TI02). The T/E 
FLIH uses the same exit as the Input/Output 
FLIH (below) . Upon return from the routine 
that processed the interruption, the T/E 
FLIH returns control directly to the inter- 
rupted routine using the T/E Old PSW if the 
system is pseudo disabled, or passes con- 
trol to the Dispatcher if the system is not 
pseudo disabled. 



INPUT/OUTPUT INTERRUPTIONS 

When an input/output (I/O) interruption 
occurs, the current PSW is stored in the 
I/O Old PSW and the I/O New PSW becomes the 
current PSW, thereby giving control to the 
I/O First-Level Interruption Handler (FLIH) 
(see Diagram 7). The I/O FLIH uses the 
Trace routine to record the interruptiin on 
the Trace Table (optional) , and passes con- 
trol to the I/O Supervisor to process the 
interruption. Upon return, the I/O FLIH 
uses the same exit as the Timer/External 
FLIH (above) , loading the I/O Old PSW if 
the system is pseudo-disabled, or branching 
to the Dispatcher if the system is not 
pseudo disabled. 



PROGRAM CHECK INTERRUPTIONS 

When a program check occurs, the current 
PSW is stored in the Program Old PSW, and 
the Program New PSW becomes the current 
PSW, thereby giving control to the Program 
Check First-Level Interruption Handler (see 
Diagram 8) . The interruption is first ana- 
lyzed to determine if it is either a 
System/370 or a simulated System/360 Mon- 
itor Call instruction. If it is, the 
Generalized Trace Facility routines are 
used to record the event, and control is 
returned directly to the user's program, or 
to the Dispatcher if a task switch is 
required. Otherwise, the Generalized Trace 
Facility routines are used to record the 
program check interruption and return con- 
trol to Program Check FLIH to continue pro- 
cessing. If no error- handling routine has 
been specified for this type of error, the 
Program Check FLIH passes control to ABTERM 
(IEA0PL00) to schedule abnormal termination 
of the program. If an error-handling rou- 
tine has been provided by the user, the 
Program Check FLIH passes control to it. 
Upon return, the Program Check FLIH issues 
an SVC 3 (EXIT) instruction to pass control 
to EXIT (IEAATAOO). 



DISPATCHER PROCESSING 

The Dispatcher provides return linkage 
between the supervisor routines and the 
program that is to receive control next 
using the two pointers NEW and OLD (IEATCBP 
and IEATCBP+4) within the Dispatcher (see 
Diagram 9) . Upon entry to the Dispatcher, 
OLD contains the address of the TCB for the 
last program to have control; NEW contains 
the address of the TCB for the program to 
receive control next, or is set to indi- 
cating that the Dispatcher is to determine 
which task is to receive control. If NEW 
is 0, the Dispatcher finds the TCB for the 
highest priority task that is ready, and 
sets OLD equal to NEW. If NEW points to a 
TCB different from the one pointed to by 
OLD, OLD is set equal to NEW. If tracing 
facilities have been specified, the Dis- 
patcher uses the Trace Table routine (a 
system generation option) , or if active, 
the Generalized Trace Facility (GTF) rou- 
tines to record the task switch. For all 
cases, the Dispatcher uses the Timer ENQ 
routine (IEAQTI02) to process timer options 
included in the system and specified for 
the new task. If the request block pointed 
to by the TCB is for a transient SVC that 
is no longer in storage, the Dispatcher 
uses the SVC SLIH to create and queue an 
SVRB. This SVRB represents the subroutine 
FINCH within the Dispatcher, which passes 
control to Program Fetch. Program Fetch 
loads the transient SVC routine. The Dis- 
patcher passes control to the program by 
loading the resume PSW from the request 
block at the top of the queue. 
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HANDLING MACHINE-CHECK INTERRUPTIONS 

The function of Machine-Check Handling 
is to intercept ma chine- check interruptions 
and attempt to recover from and report on 
the particular machine malfunction. 

The machine- check recovery programs 
available vary with the System/360 or 
System/370 model being used. The availabi- 
lity of each depends on the CPU and the 
other recovery management program (s) 
selected. There is one channel recovery 
program available to service both System/ 
360 and System/370. Figure 11 indicates 
the availability of each of these programs. 

The System Environment Recording, Edit- 
ing, and Printing program (SEREP) is avail- 
able for the Model 30 and each higher num- 
bered model except for System/370 Model 
155. 



minates the job step affected by the 
machine check and causes resumption of 
processing, or places the CPU in the 
wait state. 

If a Machine-Check Handler program has 
been selected, the machine loads the 
Machine-Check New PSW, and control is 
given to the Machine-Check Handler. 
This program records environmental data 
and attempts to recover from the 
machine check. If recovery is not 
possible, the Machine-Check Handler 
places the CPU in the wait state. 

Note ; When a System/360 or System/370 
CPU is placed in the wait state, the 
operator may then load the System 
Environment Recording, Editing, and 
Printing program (SEREP) in order to 
format and print the CPU logout area. 



Functions of the Machine Check Handlers 

When a machine-check interruption 
occurs, the processing varies according to 
the recovery option that the user has 
selected: 

• If no recovery program has been 
selected, the machine loads the 
Machine-Check New PSW, and the CPU is 
placed in the wait state. 

• If the SERO routine has been selected, 
the machine loads the Machine-Check New 
PSW, and control is given to the resi- 
dent portion of the SERO routine to 
record the environmental data. The 
SERO routine then places the CPU in the 
wait state. 

• If the SER1 routine has been selected, 
the machine loads the Machine- Check New 
PSW, and control is given to the SER1 
routine. This routine records environ- 
mental data and either abnormally ter- 
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^-Available only if a 2860, 2870, 2880, 

145, or 155 channel is selected. 
2 MCH cannot be used with SERO or SER1. 
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A = automatically included 
M = must be included 
NA = not available 
O = optional 



Figure 11. Availability of Machine-Check 
Programs 
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TASK SUPERVISION 



The task supervision routines control 
the execution of tasks primarily by creat- 
ing and managing task control blocks. By 
using these routines, user and supervisor 
programs can change the sequence and timing 
of events occurring in the central proces- 
sing unit. Following is an overview of the 
services and functions provided by task 
supervision. For additional information on 
supervisor services, see Supervisor Ser- 
vices and Macro Instructions, 



EXTRACTING INFORMATION FROM A TASK CONTROL 
BLOCK (MFT WITH SUBT ASKING) 

The EXTRACT routine allows the user to 
obtain information from a TCB. The TCB 
must be either the TCB of the issuing pro- 
gram or the TCB of one of its subtasks. 
The information, extracted from one or more 
of seven fields in the TCB, is returned in 
a main storage location supplied by the 
user. 



TASK SUPERVISION SERVICES 

The following paragraphs summarize the 
services provided by task supervision in 
MFT. Each service is initiated by a macro 
instruction. For information about these 
macro instructions, see Supervisor Services 
and Macro Instructions . The ATTACH routine 
described in "Task Supervision" is avail- 
able only if the subtasking option is 
included in the system. This option is 
included at system generation using the 
SUPRVSOR macro instruction. (See the pub- 
lication System Generation .) The ATTACH 
routine without the subtasking option is 
described in "Contents Supervision." 



CONCURRENT EXECUTION OF PROGRAMS WITHIN A 
PARTITION 

The task supervision ATTACH and DETACH 
routines allow a problem program to create 
a task within the bounds of the partition. 
When a program issues an ATTACH macro 
instruction, the ATTACH routine builds a 
task control block for the program speci- 
fied by the user. This specified program, 
called a subtask, has the attributes of any 
other task in the system. Thus, the sub- 
task is able to compete with all other 
tasks for the use of system resources. 

The DETACH routine allows the user to 
release the main storage and other 
resources that were allocated to a subtask 
but were not freed when the subtask 
terminated. 



CHANGING THE DISPATCHING PRIORITY OF A TASK 

The priority of a task is determined by 
its position on the TCB queue. By issuing 
a CHAP macro instruction, the user can 
change a task's position on the TCB queue 
and thus alter its dispatching priority. 



LIMITED EXTRACT (MFT WITHOUT SUBTASKING) 

The EXTRACT macro instruction allows a 
user to determine the address of the task 
input/ output table for the job step. 



COMMUNICATING THE COMPLETION OF AN EVENT 

The WAIT and POST routines allow a pro- 
gram to wait for the completion of an 
event. When a program issues a WAIT macro 
instruction, the WAIT routine places the 
caller in a wait state. When a servicing 
program (for instance, the I/O supervisor 
performing an I/O operation) completes the 
required event, it issues a POST macro 
instruction. The POST routine indicates 
the completion of the event and frees the 
waiting program. 

A program may wait on more than one 
event and may also wait on fewer events 
than specified. For instance, the user may 
place a program into a wait condition pend- 
ing the completion of any one of three I/O 
operations. When one I/O operation com- 
pletes, the user's program regains control. 



GAINING EXCLUSIVE ACCESS TO SYSTEM 
RESOURCES 

The ENQ and DEQ routines allow the user 
to obtain exclusive control of a resource 
and thus not allow another task to use that 
resource until it is freed. The resources 
that can be obtained in this manner include 
one or more data sets, programs, or work 
areas within main storage. 

The DEQ routine releases the resources 
obtained by the user through the ENQ macro 
instruction. 
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SERIALIZING THE USE OF SHARED DATA SETS 
(SHARED DASD ONLY) 

The ENQ and DEQ routines allow the user 
to serialize the use of shared data by 
indicating to the I/O supervisor when to 
reserve and when to release shared, direct 
access devices . If two CPUs share a direct 
access device, then each CPU must issue a 
RESERVE macro instruction (the RESERVE 
macro instruction passes control to the ENQ 
routine) before using the device, and a DEQ 
macro instruction when the device is no 
longer needed. 



INCREASING SYSTEM AVAILABILITY 

The STAE and SPIE routines offer a means 
of intercepting conditions that would 
otherwise result in abnormal termination. 
When an abnormal condition is intercepted, 
control is passed to user-provided error 
routines that analyze and, if possible, 
correct the error. 

STAE (specify task asynchronous exit) 
allows the user to intercept an abnormal 
termination whenever the task enters the 
Abnormal End routine (ABEND). Through the 
parameters of the STAE macro instruction, 
the user instructs the system to pass con- 
trol to a user's error routine whenever an 
abnormal condition is detected. 

STAE can be used to prevent abnormal 
termination during the processing of a 
supervisor service or data management rou- 
tines called by the user. Supervisor ser- 
vices such as GETMAIN, FREEMAIN, LINK, and 
XCTL and data management routines such as 
GET, PUT, OPEN, and CLOSE are provided in 
the operating system as a service to the 
user. An error occurring in these routines 
usually results in the user's task being 
abnormally terminated. Also, an error in a 
lower-level program invoked by CALL, LINK, 
LOAD, XCTL, or ATTACH macro instructions 
can result in abnormal termination. In 
both of the previously mentioned cases, the 
user can use STAE to prevent abnormal 
termination. 

The SPIE (specify program interruption 
exit) routine allows the user to specify an 
error routine that processes selected kinds 
of program interruptions. The user selects 
the kind of program interruptions to be 
serviced by the error routine through the 
parameters available in the SPIE macro 
instruction. 



THE FUNCTIONS OF TASK SUPERVISION 

The functions of task supervision are 
creating and maintaining task control 



blocks , and scheduling and allocating sys- 
tem services and resources. 

Functions related to creating and main- 
taining task control blocks are restricted 
to MFT systems with subtasking and include 
the following: 

• Creating a subtask (ATTACH) . 

• Detaching a subtask when it has com- 
pleted execution (DETACH) . 

• Changing the dispatching priority of a 
task control block (CHAP). 

• Extracting information from a task con- 
trol block (EXTRACT). 

The allocating and scheduling functions 
include: 

• Causing a program to wait for one or 
more events (WAIT) . 

• Posting the completion of an event 
(POST) . 

• Serializing the use of a resource (ENQ, 
RESERVE) . 

• Releasing a resource from exclusive 
control (DEQ). 

• Specifying a program interruption exit 
(SPIE) . 

• Specifying a task asynchronous exit 
(STAE) . 

• Scheduling an end-of-task exit routine 
(ETXR operand) . 



CREATING A SUBTASK 

When a user program issues an ATTACH 
macro instruction, the ATTACH routine gets 
control to build a task control block and 
queue the TCB on the TCB queue (see Diagram 
10). ATTACH builds a dummy program request 
block (PRB) and queues it to the new TCB. 
ATTACH initializes the resume PSW field of 
the PRB with the address of an SVC 6 (LINK) 
instruction contained in the CVT. This 
procedure establishes linkage to the 
requested program so that the program will 
execute under control of the new TCB (see 
"Linking to the Subtask" below) . 

Prior to queueing the TCB, ATTACH pre- 
pares for subtask termination as follows: 

• If the caller did not specify an event 
control block (ECB) or ETXR address 
through the operands of the ATTACH 
macro instruction, ATTACH schedules a 
system end-of-task exit routine. 
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• If the caller specified an ECB address, 
ATTACH checks the validity of the 
address. 

• If the caller specified an ETXR 
address, ATTACH establishes linkage to 
the user end- of- task exit routine. 

Upon completion of its processing, ATTACH 
issues an SVC 3 (EXIT) instruction. When 
the TCB created by ATTACH is the highest 
priority TCB that's ready, the LINK macro 
instruction is executed which brings the 
requested module into the partition and 
queues the request block for the module to 
the RB queue of the new TCB (see Diagram 
11). LINK issues an SVC 3 (EXIT) instruc- 
tion which causes its own SVRB to be 
removed from the RB queue, leaving only the 
newly created request block for the module. 
The requested module gains control when the 
Dispatcher determines that it is the high- 
est priority ready task in the system. 

TCB Address Table 

Before processing the request to create 
a subtask, ATTACH searches the TCB address 
table to determine whether the maximum 
number of active subtasks is currently 
executing. The TCB table is created during 
system generation and initialized during 
nucleus initialization (NIP) to address the 
system task TCBs in order of priority. The 
TCB address table also contains empty 
fields following the partition TCB entries. 
These fields are used by ATTACH to address 
subtasks created by the system. The number 
of empty fields created during system 
generation corresponds with the maximum 
number of subtasks that can exist at any 
given time. 

Queuing the Task Control Block 

When the task receives control from the 
initiator/terminator, the TCB queue is 
arranged by priority, with the system tasks 
having the highest dispatching priorities 
at the top of the queue. The partition 
TCBs are queued below the system TCBs and 
range in priority from the highest, parti- 
tion 0, to the lowest, partition n. 

ATTACH places the subtask TCB on the 
dispatching queue, using its dispatching 
priority to determine its position. Once a 
new TCB is queued, the partition priority 
scheme is no longer relevant because sub- 
tasks TCBs may be assigned any priority 
lower than that of the creating task. 

Since a subtask belongs to a particular 
job step, the subtask" s TCB must also be 
queued to the calling task's TCB. If there 
are other subtask TCBs on this subtask 
queue, the TCB for the newly created task 
is placed on the top of the queue. The 



subtask queue is used to terminate all the 
subtasks of a job step task and to change 
the dispatching priority of a subtask. 

When the time-slicing feature is 
included in the system, the ATTACH routine 
determines whether the new TCB represents a 
time-sliced task. A task is time-sliced if 
its dispatching priority falls within the 
limits of the dispatching priorities 
assigned to the time-sliced group. If the 
new task is time-sliced, ATTACH sets the 
time-slice bit (TCBFTS) in the TCB and 
updates the pointers in the Time Slice Con- 
trol Element (TSCE) . 



Determining Whether a Task Switch is Needed 

ATTACH determines whether the caller 
(parent task) or the subtask (daughter 
task) will receive control first from the 
Dispatcher. The dispatching priority of 
the parent task is compared to that of the 
daughter task and the address of the task 
with the higher priority is stored in the 
NEW TCB pointer (IEATCBP). NEW is later 
tested by the Dispatcher in determining 
which task gets control first. 



Linking to the Subtask 

Diagram 10 illustrates the TCB queue 
just before control passes to EXIT from 
ATTACH. The SVRB controlling the execution 
of the ATTACH routine is at the top of the 
RB queue between the caller's RB and the 
TCB. The subtask TCB is queued on the TCB 
queue in the position assigned to it 
according to its dispatching priority. The 
dummy PRB's resume PSW addresses an SVC 
(LINK) instruction. When the subtask TCB 
is dispatched, the one-instruction program 
(SVC 6) executes. The SVC handlers build 
an SVRB for the LINK routine and queue it 
at the top of the subtask' s RB queue. 

LINK obtains the name of the requested 
program from the caller's registers and the 
ATTACH parameter list (the parent task's 
registers were stored in the subtask TCB by 
ATTACH) . LINK processes the request as 
follows: 

• An attempt is made to find the 
requested program in main storage. 

• If the search for the program is not 
successful, the program is loaded into 
main storage. 

o An RB is built to control the execution 
of the program. 

• The RB belonging to the caller (in this 
case the dummy PRB) is removed from the 
RB queue. 
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Diagram 11 illustrates the subtask TCB' s 
RB queue at entry to LINK, at completion of 
LINK processing , and at completion of EXIT 
processing. 



DETACHING A SUBTASK 

The DETACH routine permits a program 
(the parent task) to detach its subtask 
(daughter task) if the daughter task has 
terminated, A DETACH macro instruction 
must be issued if the ECB or ETXR operands 
were originally specified in the ATTACH 
macro instruction that created the subtask. 
DETACH processes a request as follows: 

• Checks the validity of the subtask" s 
address. 

• Dequeues the subtask 's TCB from all 
queues to which it belongs (that is f 
the dispatching queue, the subtask 
queue, and, if applicable, the time- 
slice queue) . 

• If the subtask has not terminated, 
DETACH branches to ABTERM to terminate 
the subtask. If an ECB address was 
originally passed in the parameters of 
the ATTACH macro instruction, DETACH 
adjusts the ECB to inform the parent 
task that the daughter task has abnorm- 
ally terminated. 

• Returns control to the caller by issu- 
ing an SVC EXIT instruction. 



CHANGING THE DISPATCHING PRIORITY OF A TASK 

The CHAP macro instruction permits a 
problem program executing in a partition to 
change its own dispatching priority or the 
dispatching priority of any of its sub- 
tasks. A program issuing the CHAP macro 
instruction may change the dispatching 
priority to any value between and the 
limit priority of the issuer's TCB. Dia- 
gram 12 illustrates the relative positions 
of TCBs on the queue before Program A 
issues an ATTACH macro instruction, after 
the ATTACH is issued, and after Program A 
changes its own dispatching priority. The 
distinction between dispatching and limit 
priorities is explained in the next 
paragraphs . 

Both limit and dispatching priorities 
are specified as parameters of the ATTACH 
macro instruction. The dispatching priori- 
ty determines the appropriate position of a 
TCB on the TCB queue, and thus determines 
which task or subtask gains control after 
an interruption occurs. The Dispatcher 
places in execution the ready program 
represented by the TCB of highest dispatch- 
ing priority. In contrast, the limit 



priority of a task is used by the CHAP SVC 
routine to determine the maximum value to 
which it may increase the dispatching 
priority of the task. The limit priority 
of any subtasks will not be more than the 
limit priority of the originating task. 

After the dispatching priority is 
changed, the CHAP routine rearranges the 
TCB queue by placing the affected TCB in a 
new logical location reflecting its new 
priority. If the changed task's new 
priority falls within the range of priori- 
ties assigned to the time-slice group, CHAP 
places the TCB on time-slice queue. 

The CHAP routine can also be used to 
increase the limit priority of any of the 
active task's subtasks. The active task 
cannot change its own limit priority. When 
the dispatching priority of a subtask is 
raised above its own limit priority, the 
CHAP routine raises its limit priority to 
equal its new dispatching priority. Howev- 
er, a subtask' s limit and dispatching 
priority cannot exceed the job-step's limit 
priority. 

Reference information on using the CHAP 
macro instruction can be found in Super vi- 
sor Services and Macro Instructions. 



CAUSING A PROGRAM TO WAIT FOR ONE OR MORE 
EVENTS 

The WAIT routine allows a user or system 
program to wait until a specified number of 
events has occurred, such as the completion 
of one or more I/O operations. When the 
event is completed, the POST routine re- 
cords the completion of the event in a com- 
munication area called the event control 
block (ECB) and takes the waiting program 
out of the wait condition if no other 
events are being waited on. 

The functions performed by the Wait rou- 
tine are: 

• Placing the requesting program into a 
wait state. 

• Initializing the wait flag in the event 
control block (ECB). 

• Incrementing the wait count in the cal- 
ler 's RB. 

Initializing the Event Control Block 

The event control block is specified by 
a program when it issues a WAIT macro 
instruction. The ECB must be initialized 
by the caller so that bits and 1 (the 
wait and completion bits respectively) are 
set to 0. The WAIT routine sets the wait 
bit to 1 upon entry. If the user specifies 
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more than one ECB, the wait bit in each ECB 
is set to 1 by the WAIT routine. The wait 
bit indicates to the POST routine that the 
event represented by an ECB is being waited 



The WAIT routine also places the address 
of the waiting program's request block into 
the address portion of the completion- code 
field of the ECB, so that the POST routine 
can identify the waiting program. 

Keeping Track of the Number of WAITs Issued 
by a Program 

The wait count (the number of WAIT macro 
instructions issued by a routine) is main- 
tained in the caller 's RB by the WAIT rou- 
tine. The wait count is incremented by the 
WAIT routine whenever it is entered. 
However, if the WAIT routine finds that the 
event to be waited on has already occurred, 
it decrements the wait count by one. Thus, 
the wait count retains its original value. 
If the wait count becomes 0, the caller is 
not placed in a wait state. 



POSTING THE COMPLETION OF AN EVENT 

The POST routine permits a program (the 
"posting" program or caller) to signal the 
completion of an event such as an I/O 
operation. The POST routine signals (posts) 
the event's completion by setting the com- 
pletion bit in the ECB shared by both the 
waiting and posting program. The POST rou- 
tine also places in the ECB a completion 
code, if the posting program supplies one. 
The completion code may later be inspected 
by the waiting program after it resumes 
execution to determine the type of comple- 
tion that occurred. The POST routine 
returns control to the caller via the type 
1 Exit routine. 



the request queue and reduces the wait 
count for the waiting program. If the wait 
count becomes 0, the DEQ routine, via the 
Exit routine and the Dispatcher, returns 
control to the previously waiting (now 
ready) program. The latter then gains 
access to the resource. 

Types of Resource Requests 

There are two types of resource requests 
which may be specified using the ENQ macro 
instruction: an exclusive (E) request or a 
shared (S) request. The ENQ routine 
handles these two types of requests dif- 
ferently. Exclusive requests are handled 
on a first-in, first-out basis. That is, 
an exclusive request in the queue may not 
be serviced until all earlier requests of 
either type have been serviced. Also, 
later requests of either type may not be 
serviced until a previously entered exclu- 
sive request has been handled. However, 
shared requests placed consecutively in the 
queue may be serviced as a group, if one of 
the shared requests is at the top of the 
queue. That is, the group of shared 
requests are handled on a task-priority 
basis. Figure 12 indicates the handling of 
typical combinations of shared and exclu- 
sive requests. 

Description of the Resource Queues 

Each resource request in the ENQ macro 
instruction specifies a qname, which names 
a set of resources, and an rname which 
names a single resource within the set 
identified by the qname. The qname is 
represented on the resource queues by a 
major queue control block (QCB) . Each 
major QCB contains the qname for a set of 
resources, for example, the name of a data 
set. A major QCB thus represents a set of 
resources. 



SERIALIZING THE USE OF A RESOURCE 

The ENQ routine permits programs issuing 
the ENQ macro instruction to gain one-at-a- 
time access to a resource or set of 
resources. The requested resource may 
include one or more data sets, records 
within a data set, programs, or work areas 
within main storage. The routine places in 
a resource queue all resource requests spe- 
cified in the caller's macro instruction. 
If no other program is using a requested 
resource, the requester gains access to its 
resource. But if any requested resource is 
already in use by another program, the ENQ 
routine places the caller in a wait condi- 
tion until the resource becomes available. 
When the resource is no longer needed by 
the other program, that program issues a 
DEQ macro instruction that causes the DEQ 
routine to remove one or more elements from 



A nonexecutable module has as its first 
word the address of the first major QCB. 
Each major QCB points to a minor QCB, which 
represents a particular resource within the 
set of resources, for example, a specific 
record within a data set. A minor QCB con- 
tains an rname that is the name of the par- 
ticular resource that has been requested. 
Each minor QCB, if another resource within 
the set has been requested, points to 
another minor QCB. Thus, each minor QCB 
represents a particular resource that has 
been requested within a set of resources 
represented by a major QCB. 

Each minor QCB contains the list origin 
for a queue of one or more queue elements 
(QELs) . Each QEL represents a request for 
a single resource by a program belonging to 
a specific task. If a program requests 
more than one resource, the ENQ routine 
constructs additional QELs, each represent- 
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Condition 1 : 

A group of shared requests 
is at the top of the re- 
source queue. 



shared request 
shared request 
exclusive request 



The resources are used by the shared 
requesters on a task-priority basis. 
The exclusive requester waits until 
the shared requesters have completed 
their use of the resource and have 
removed their requests from the 
queue. 



Condition 2 : 

An exclusive request at 
the top of the queue is 
followed by a group of 
shared requests. 



Condition 3 : 

An exclusive request at 
the top of the queue is 
followed by a second ex- 
clusive request. 



--+ 



exclusive request 
shared request 
shared request 



The exclusive requester has access 
to the resource. The shared reques- 
ters wait until the resource is 
free. They then share the resource 
on a task-priority basis. 



exclusive request 
exclusive request 



Condition 4 : 

A group of shared requests 
is at the top of the 
queue, followed by an ex- 
clusive request. The ex- 
clusive request is fol- 
lowed by a group of shared 
requests. 



The first (top) exclusive requester 
uses the resource while the second 
exclusive requester waits. When the 
first requester has completed its 
use of the resource, the second 
requester can proceed. 



shared request 
shared request 
exclusive request 
shared request 
shared request 



The resource is first shared on a 
task-priority basis by the shared 
requesters whose requests are at the 
top of the queue. The exclusive re- 
quester waits until the shared re- 
questers have completed their use of 
the resource and have removed their 
requests from the queue. The exclu- 
sive requester then has exclusive 
access to the resource. The shared 
requesters lower on the queue wait 
until the resource is available. 
They then share the resource on a 
task-priority basis. 



Figure 12. Handling Shared and Exclusive Requests 



ing a request. If all the QELs that repre- 
sent resource requests by a program are at 
the top of their respective QEL queues, the 
program may use the resources. That is, 
the program is not waiting and can gain 
access to the resources as soon as it is 
dispatched. But if all the QELs that 
represent requests by a program are not at 
the top of their respective QEL queues, the 
requesting program must wait. The program 
that is using the resources must finish and 
issue a DEQ macro instruction. The DEQ 
routine then moves the needed QELs to the 
top of the queues. 

In Figure 13 f program A is using, or is 
about to use, the resources represented by 
major QCB 1 and minor QCBs 1 and 2. Its 
requests are at the top of the queues, 
represented by QELs 1 and 2. Program B has 



requested one of the resources being used 
by program A, that represented by major QCB 
1 and minor QCB 2. Since the resource 
desired by program B is already in use, the 
program must wait, its request remaining on 
the queue as QEL 3. 

Note that each requested resource is 
represented by a combination of one major 
QCB and one of its associated minor QCBs. 
Each request is represented by a queue ele- 
ment (QEL) , which points to the TCB asso- 
ciated with the requesting program. If 
there is not at least one QEL for a pre- 
viously requested resource, the DEQ rou- 
tine, when the DEQ macro instruction is 
issued, removes the associated minor QCB. 
(Under certain conditions, the DEQ routine 
also removes a major QCB.) Thus, if there 
are control blocks — major QCB, minor QCB, 
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Module IEAQCB01 





\ First QCB 


A 

68 


r SAVE AREA ; 


72 


"HEADQCB" (in EBCDIC character format) 



Major QCB 1 



Major 

QCB 

Queue 



Points to next 
or last major 
GCB on the queue 
(if one exists) 



5" 




Minor QCB 1 


/ 


/ 


/ 


/ 


Rname 1 



QEL 1 



■Minor QCB Queue - 
Minor QCB 2 



■i 




QEL 
Queues 



Program X 


Program Y 



NOTES: 1. Arrows represent pointers. 

2. Each combination of a major QCB, a minor QCB, and a QEL represents a resource requested for a particular task. 

3. Program X is using resources Rname 1 and Rname 2. 

4. Program Y awnits resource Rname 2. 

Figure 13. Resource Queues 



and QEL — on the resource queues, there 
must be at least one request for a resource 
that has not yet been completed. 



Functions of the ENQ Routine 

MAJOR FUNCTIONS ; When one or more 
resources are requested, via the ENQ macro 
instruction, the major functions are: 

• If necessary, creating one or more 
queue control blocks (QCBs) to repre- 
sent the requested resource, and plac- 
ing these queue control blocks on the 
resource queues. 

• Depending on the RET parameter, creat- 
ing a queue element (QEL) to represent 
the request, and placing the QEL on a 
QEL queue. 

• If the resource is available, returning 
control to the requester, with or 
without a return code that indicates 



the availability of the resource, 
depending on the RET parameter. 

• If the requested resource is not avail- 
able, taking one of two actions, 
depending on the RET parameter: 

- Placing the requester in a wait con- 
dition, pending the availability of 
the resource 

- Returning control to the requester 
with a code that indicates that the 
resource is unavailable. 



MINOR FUNCTIONS: 



When one or more 



resources are requested, the minor func- 
tions are: 

© Setting the caller's task to "must com- 
plete" status, if specified and the 
caller has a protect key of 0. 

• Detecting abnormal conditions that can 
cause the generation of an error code 
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or the abnormal termination of the cal- 
ler's task. 

© Purging QELs from the resource queues 
for an abnormally terminated task. 

© Increasing the "enqueue count" in the 
requester's TCB. 

FUNCTIONS OF THE ENQ ROUTINE WHEN A RESERVE 
REQUEST IS ISSUED : When a caller issues a 
RESERVE macro instruction to reserve a 
resource, the ENQ routine: 

o Creates, if necessary, one or more 
queue control blocks (QCBs) to repre- 
sent the requested resource. These 
control blocks are then queued on the 
resource queues. 

o if the resource is available, the re- 
quester gives control of the resource 
with a return code that indicates the 
availability of the resource, depending 
on the value coded in the RET parameter 
of the ENQ macro instruction. 

© If the requested resource is not avail- 
able, one of two actions is taken: 

- Places the requester in a wait condi- 
tion, pending the availability of the 
resource. 

- Returns control to the requester with 
a code indicating that the resource 
is unavailable. 

Functions of the DEQ Routine 

When a program that previously issued an 
ENQ macro instruction (or, in systems that 
include the shared DASD feature, a program 
that issued a RESERVE macro instruction) is 
through with the requested resource, it 
releases the resource by issuing a DEQ 
macro instruction. The DEQ macro instruc- 
tion, via an SVC 48 instruction, obtains 
supervisor-assisted linkage to the DEQ rou- 
tine. This routine removes one or more 
QELs, a minor QCB, or a major QCB from the 
resource queues. It also reduces the RB 
wait count for the waiting program whose 
QELs are at the top of the QEL queue. If 
the RB wait count becomes 0, indicating 
that the waiting program is ready, the DEQ 
routine determines whether a task switch is 
needed, and issues an SVC 3 (EXIT) instruc- 
tion to return control. The program that 
receives control is either the caller or a 
previously waiting program, depending on 
relative task priority. 

An additional function of the DEQ rou- 
tine, used only by a supervisor routine, is 
to turn off the "must complete" flags in 
the TCB set previously by an ENQ macro 
instruction issued by the caller. 



MAJOR FUNCTIONS: 



When the use of one or 



more resources is signaled complete, via 
the DEQ macro instruction, the major func- 
tions are: 



Updating the resource queues by dequeu- 
ing and freeing the queue element (QEL) 
that represents the request for the 
resource. If there are no more 
requests for the resource, one or more 
queue control blocks (QCBs) that repre- 
sent the resource are dequeued and 
their space is freed. 



o For the next requester represented on 
the QEL queue, reducing the wait count 
in its RB, and determining whether the 
requester is ready to resume execution. 



© Comparing dispatching priorities to 
determine whether a readied requester 
can replace the caller as the next- to- 
be executed routine. 



Returning control to the caller if no 
other readied requester's task has a 
higher priority than the caller's. If 
another readied requester's task has a 
higher priority, control is returned to 
the other requester instead of to the 
caller. 



MINOR FUNCTIONS : When the use of one or 
more resources is signaled complete, via a 
DEQ macro instruction, the minor functions 
are: 



© clearing of the "must complete" status 
of the caller's task, if the "reset 
must complete" parameter is present. 

© checking the validity of input 
addresses. 

© Determining whether a specified 

resource was originally requested for 
any task. 

© Checking whether the caller has access 
to a specified resource. 

© Reducing the "enqueue count" in the 
caller's TCB. This count is tested 
during normal task termination by the 
EOT routine to determine if all 
resource requests for the task have 
been dequeued. (See "Termination 
Procedures.") 

© Issuing an EXCP instruction to release 
a reserved resource when the reserve 
count in the UCB is 0. 
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SIGNALING THAT A RESERVED RESOURCE IS NO 
LONGER NEEDED 

When a program that previously issued a 
RESERVE macro instruction is finished using 
the reserved resource, it issues a DEQ 
macro instruction. The DEQ routine decre- 
ments the UCB reserve count pointed to by 
the specified minor QCB. DEQ then removes 
the minor QCB from its queue if the UCB 
reserve count (field UCBSQC in the UCB) has 
become 0. If there are no additional minor 
QCBs queued to the major QCB, DEQ frees the 
main storage of the major QCB. The DEQ 
routine also decrements the task enqueue 
count in the TCB (field TCBLMP) to indicate 
that a resource was freed. If the UCB 
reserve count is 0, DEQ issues an EXCP to 
free that device. 



INTERCEPTING PROGRAM-CHECK INTERRUPTIONS 

When a program interruption occurs, the 
program- interruption handler passes control 
to ABEND to abnormally terminate the task 
and (optionally) provide a dump. 

The sequence of events taking place when 
a program interruption occurs can be 
altered. The SPIE macro instruction allows 
the user to specify a user-written routine 
that is to get control when a program 
interruption occurs. 

Creating the Program Interruption Control 
Block 



SPECIFYING A TASK ASYNCHRONOUS EXIT 

The STAE routine allows the user to 
specify an abnormal exit for a task. When 
a STAE macro instruction is issued, control 
is passed to the STAE routine (see Diagram 
13) . The STAE routine creates a STAE con- 
trol block (SCB) to be used later when 
abnormal termination is scheduled. 



Information Returned to User 

When control is returned to the user 
after the STAE macro instruction has been 
issued, register 15 contains one of the 
following return codes: 



Code Meaning 
00 An SCB is successfully created, 
overlaid, or canceled. 

04 Storage for an SCB is not 
available. 

08 The user is attempting to cancel 
or overlay a non-existent SCB, or 
is issuing a STAE in his STAE 
exit routine. 

0C The exit routine or parameter 
list address is invalid. 

10 The user is attempting to cancel 
or overlay an SCB not associated 
with his level of control. 



The SPIE macro instruction creates 
executable coding during assembly of the 
source program. When executed, this coding 
creates and initializes a program interrup- 
tion control area (PICA) to be used by the 
SPIE routine when it gets control following 
a program interruption. 

Functions Performed by the SPIE Routine 

The SPIE routine completes the proces- 
sing needed for a user to specify a 
program-interruption exit routine. 

o SPIE obtains 32 bytes of main storage, 
builds a program- interruption element 
(PIE) , and places the address of the 
PIE in the TCB. 

o SPIE places the address of the PICA in 
the first four bytes of the PIE. 

o SPIE stores a program mask (as deter- 
mined from the types of interruptions 
to be intercepted) in the caller's 
resume PSW. 

See Section 5 for the formats of the PIE 
and PICA. 



Processing When an Abnormal End is 
Indicated 

When a program that issued a STAE macro 
instruction loses control to the ABEND rou- 
tine as a result of an abnormal condition, 
the first load of ABEND calls the ABEND/ 
STAE interface routines. 

The ABEND/STAE interface routines: 

o Purge active I/O. 

o Establish a work area for the user's 
exit routine. 

o Schedule the user's exit routine. 

o Schedule the user's retry routine 
(optional) . 

Information Passed to User's Exit Routine 

Before the user's exit routine is 
entered, the purge request , as specified in 
the STAE macro instruction, has been 
handled. The registers contain the follow- 
ing information: 
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Register 0: One the following codes 
indicating the status of I/O operations 
for the task: 



Code Meaning 
Active I/O at the time of the 

abnormal condition was halted and 
is restorable. 

4 Active I/O at the time of the 

abnormal condition was halted and 
is not restorable. 

8 No I/O was active at the time of 
the abnormal condition, or the 
STAE macro instruction specified 
PURGE=NONE. 

• Register 1: Address of a 104-byte work 

area. 

• Registers 2-12: Unpredictable. 

• Register 13: Address of a register 
save area. 

• Register 14: Return address. 

• Register 15: Address of the STAE exit 
routine. Registers 13 and 14, if used 
by the STAE exit routine, must be saved 
and restored prior to returning to the 
calling program. Standard linkage con- 
ventions are used. 

If storage was not available for the 
work area, the register contents upon entry 
to the user exit routine are as follows: 

• Register 0: 12. 

• Register 1: ABEND completion code as 
it appears in the TCBCMP field. 

• Register 2: Address of STAE exit para- 
meter list. 

• Register 3-13: Unpredictable. 

• Register 14: Return address. 

• Register 15: Address of the STAE exit 
routine. Registers 13 and 14, if used 
by the STAE exit routine, must be saved 
and restored prior to returning to the 
calling program. Standard linkage con- 
ventions are used. 



The User's Retry Routine 

Upon completion of the user's exit rou- 
tine, the user indicates whether ABEND pro- 
cessing is to continue for the task or a 
STAE retry routine should be scheduled. 
The return codes to be placed in register 
15 are as follows: 



Code Meaning 
ABEND processing to continue. 

4 A retry routine has been provided and 
the request block chain should be 
purged. 

8 A retry routine has been provided and 
the request block chain should not be 
purged. 

The address of the retry routine will be 
returned from the user's exit routine in 
register 0. 

The purpose of the user's retry routine 
is to restart the task. Upon entry to 
retry routine, the registers contain: 

• Register 0: 0. 

• Register 1: Address of the work area, 
as previously described, except that 
word 2 now contains either the address 
of the first I/O block on the restore 
chain, and word 26 now contains the 
address of the I/O block restore chain. 
Both words contain if I/O was not 
purged. 

• Registers 2-13: Unpredictable. 

• Register 14: Return address. 

• Register 15: Address of the user's 
retry routine. 

Again, if storage was not available for 
a work area, the register contents upon 
entry to the user's retry routine are as 
follows : 

• Register 0: 12. 

• Register 1: ABEND completion code. 

• Register 2: Address of the first I/O 
block on the restore chain, or if I/O 
is not restorable. 

• Registers 3-15: Same as above 3 



Relationship of STAE Modules 

The functions of STAE are performed by 
five modules: the STAE service routine 
module, and the ABEND/STAE interface rou- 
tine (ASIR), load modules 1 through 4. The 
function performed by each of these five 
modules is briefly stated below: 

• STAE service routine (IGC00060) — 

Receives control via an SVC 60 instruc- 
tion when the STAE macro instruction is 
issued. It checks the validity of the 
STAE request, and creates, cancels, or 
overlays a STAE control block (SCB) . 
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• ASIR1 (IGC0111C) — Receives control 
from the ABEND routine. It purges I/O 
operations (unless PURGE=NONE) that are 
in progress for the abnormally ter- 
minating task, establishes a work area, 
and schedules and gives control to the 
user- written STAE exit routine. If the 
exit routine does not request that a 
retry routine be executed, the Message 
Information List is purged of entries 
for the current TCB, and ASIR1 returns 
control to ABEND processing when the 
exit routine has finished. If a retry 
routine is requested, ASIR1 passes con- 
trol to ASIR2. If the program using 
STAE is in supervisor mode and requests 
execution of a retry routine without a 
purge of the RB chain, ASIR1 passes 
control to ASIR3. 

o ASIR2 (IGC0211C) — Receives control 
from ASIR1. It locates and closes data 
sets allocated to RBs between the RB 
requesting STAE and the RB of the fail- 
ing program. It uses the WT0R Purge 
routine. If any of the data sets to be 
closed are being processed by BTAM, 
QTAM, BISAM, or QISAM, ASIR2 passes 
control to ASIR4. If none of the above 
access methods are indicated, ASIR2 
passes control to ASIR3. 

• ASIR3 (IGC0311C) — Receives control 
from either ASIR1, ASIR2, or ASIR4. It 
sets the tasks related to the failing 
task dispatchable, frees the main 
storage occupied by the SCB, and sched- 
ules the user's retry routine so that 
it is the next program executed. 

• ASIR4 (IGC411C) — Receives control 
from ASIR2. It repeats the search for 
data sets that are being processed by 
BTAM, QTAM, BISAM, or QISAM, closes 
these data sets, and passes control to 
ASIR3. 



SCHEDULING A USER EXIT ROUTINE 

A user program may request the future 
execution of its exit routine to handle an 
unpredictable event, such as an end-of-task 
condition, expiration of a timer interval, 
or special I/O handling (for example, tape 
label checking or I/O error checking) . The 
scheduling of user exit routines (sometimes 
called asynchronous exit routines) is 
handled by several supervisor routines: 
the Stage 1 Exit Effector, the Stage 2 Exit 
Effector, the Stage 3 Exit Effector, and 
the EXIT routine. These routines do not 
schedule the execution of user program- 
check routines. Abnormal termination that 
results from a program check can be inter- 
cepted by a SPIE or a STAE macro 
instruction. 



As shown in Figure 14, the handling of a 
request for the future execution of a user 
exit routine is a multipart procedure, 
interwoven with the execution of programs 
that are part of other tasks. The proce- 
dure begins when the user program provides 
an exit routine via operands in such macro 
instructions as ATTACH (ETXR operand), 
STIMER, and DCB. A system routine (e.g., 
the ATTACH routine) then issues an SVC 43 
instruction to pass control to the Stage 1 
Exit Effector, which constructs an inter- 
ruption request block (IRB) to handle 
future scheduling of the user exit routine. 
In addition, the system routine constructs 
an interruption queue element (IQE), which 
Stages 2 and 3 of the Exit Effector and the 
EXIT routine later manipulate to schedule 
the execution of the user exit routine. 
Data management routines, however, do not 
construct IQEs, since I/O queue elements 
already exist. These elements are called 
request queue elements (RQEs) and are made 
available by the I/O Supervisor. 

After the Stage 1 Exit Effector con- 
structs the IRB to represent the user rou- 
tine, no scheduling occurs until an unpre- 
dictable event takes place that requires 
the exit routine. The Stage 2 Exit Effec- 
tor, a supervisor subroutine, performs ini- 
tial scheduling of the user exit routine by 
placing the previously constructed queue 
element, an IQE or RQE, on its appropriate 
exit queue. One queue contains IQEs that 
represent requests to use a routine such as 
a timer exit routine or an end-of-task rou- 
tine. The other queue represents requests 
for data management exits and contains only 
RQEs. These RQEs are the same elements 
that the I/O Supervisor uses to schedule 
I/O requests. Both exit queues operate in 
first-in, first- out order, with no regard 
to the task priority. 

When an element is placed on either exit 
queue, the IRB that represents an exit rou- 
tine is not yet on a task" s RB queue and 
cannot yet be executed. Placing a queue 
element on an exit queue by the Stage 2 
Exit Effector is therefore only a "book- 
keeping" manipulation. 

The Stage 3 Exit Effector completes the 
scheduling of the user exit routine. Stage 
3, a subroutine of the Dispatcher, removes 
queue elements from either of the two exit 
queues and places them on another queue 
whose list origin is the IRB representing 
the exit routine. The transferred queue 
elements are thus queued for a specific 
exit routine. Stage 3 completes the sched- 
uling of the user exit routine by placing 
the IRB on the RB queue of the requesting 
program's task. The exit routine, so 
scheduled, competes for CPU time with pro- 
grams being executed for other tasks. When 
the requesting program's TCB, which points 
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User program requests, via macro-instruction, 
the use of an exit routine (e.g. , STIMER or 
ATTACH) . 



System routine constructs queue element 
(IQE), if needed, and if interruption request 
block (IRB) does not already exist, issues an 
SVC 43 instruction to create IRB. 



/ SVC Interruption 



Execution of 
^Programs for 
Task A 



Exit Effector, Stage 1 



Constructs an IRB to be later used in 
scheduling the execution of the user exit 
routine 



Execution of 
•"Supervisor 
Routine 



j Occurrence of the event 
l-/ requiring the user exit 
/ routine (e.g., expiration> 
• 1 of preset timer interval 
or an end-of-task) 



J_ 



Execution of 
Programs in 
System, Based 
on Task Priority 



Exit Effector, Stage 2 



Performs initial scheduling of user exit 
routine by placing the queue element (IQE) 
on its appropriate exit queue. 



X 



< 



Dispatcher 



Recognizes that stage 2 has placed a queue 
element on one of the exit queues. Passes 
control to stage 3. 



I 



Execution of 
^-Supervisor 
Routines 



Exit Effector, Stage 3 



Completes scheduling of user exit routine 
by transferring the queue element 
(representing request for the routine) from 
an exit queue to a queue whose list origin 
is the IRB. for the routine. Places IRB on 
the RB queue belonging to the requestor's 
TCB. 



Dispatcher 



Returns control to a program belonging to a 
task other than task A 



J_ 



Dispatcher 



Gives control to the user exit routine 
requested for task A 



User Exit Routine 



EXIT Routine 



Removes top queue element from IRB's queue 
and returns it to available list of queue 
elements (If queue element is RQE, the 
transfer to available list is done by the I/O 
Supervisor; If queue element is an IQE for 
rollout/roll in, the transfer to the available 
list is done by the roll out/roll in module.) 
If there is another element on IRB's queue, 
prepares for later rescheduling of IRB on 
RB queue of another TCB. If there are no 
more queue elements on the IRB's queue, 
removes IRB from its task's RB queue. If 
IRB was dynamically acquired, frees 
storage occupied by the IRB. 



X 



Dispatcher 



Either passes control to an exit routine 
requested for another task or returns control 
to the current program of task A or another 
ready task. 
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Figure 14. Scheduling Asynchronous Exit Routines 



to the IRB ff has the highest priority among 
the ready TCBs r the Dispatcher loads the 
IRB's old PSW to give control to the user 
exit routine. 

When the user exit routine is finished, 
it invokes supervisor-assisted linkage to 
the supervisor EXIT routine. The supervi- 
sor EXIT routine removes the top queue ele- 
ment from the IRBs queue of request ele- 
ments. The removed element represents the 
satisfied request for the user exit 
routine. 

After removal from the IRB's queue, the 
queue element is returned to a free list. 



If there are more elements on the IRB's 
queue, representing other requests for the 
routine, the EXIT routine prepares for 
later rescheduling of the IRB on the RB 
queue. of a different task. If there are no 
more queue elements on the IRB°s exit 
queue, the EXIT routine dequeues the IRB 
from the TCB"s RB queue, and, if the IRB is 
not a system RB, frees the storage occupied 
by the IRB. Thus, the scheduling process, 
which began with the construction of an IRB 
at macro- execution time, ends with the 
possible release of the IRB after the user 
exit routine is complete. 
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Functions of the Exit Effectors 

The exit effectors schedule the execu- 
tion of the user exit routine in the fol- 
lowing way: 

o The Stage 1 Exit Effector creates and 
initializes, depending on the input 
parameters passed by the caller , an 
interruption request block (IRB) which 
will control the execution of the user 
exit routine. The routine contains a 
work area in which the caller may con- 
struct interruption queue elements 
(IQEs), and optionally, a 72-byte 
register save area in which the user 
exit routine may later save the regis- 
ters of the requesting program. The 
ATTACH routine uses the work area to 
construct the IQE for the ETXR or end- 
of-task exit routine. The Stage 1 Exit 
Effector obtains space for the IRB from 
the partition. The work area follows 
and is contiguous with the IRB. 

o The Stage 2 Exit Effector is entered by 
a supervisor routine to schedule a user 
exit routine. Two typical callers are 
the supervisor End-of-Task routine 
(EOT) , during end- of -task processing, 
and the Timer Second-Level Interruption 
Handler, when a preset timer interval 
has expired. Stage 2 places the queue 
element on the queue of RQEs used for 
scheduling data management exits. If, 
however, the input address is in com- 
plement form. Stage 2 interprets the 
input queue element as an IQE and 
places it at the end of the IQE list, 
whose elements are used to schedule 
non-data-management exits. (See Sec- 
tion 5 for the format and content of 
IQEs and RQEs.) Stage 2 then sets a 
Stage-3 switch (IEA0DS01), which the 
Dispatcher will test later to determine 
whether to call Stage 3 to complete the 
scheduling begun by Stage 2. 

• The Stage 3 Exit Effector operates as a 
subroutine of the Dispatcher. Its pur- 
pose is to transfer IQEs and RQEs from 
their exit queues to queues belonging 
to particular IRBs and, if possible, to 



place these IRBs on the RB queues of 
the appropriate TCBs. As soon as an 
IRB is on an RB queue, the exit routine 
represented by the IRB may (if task 
priority permits) be placed in execu- 
tion by the Dispatcher. An additional 
function of Stage 3 is to schedule a 
request (RQE) for an I/O error routine 
by placing its system interruption 
request block (SIRB) on the system 
error task TCB. (MFT with subtasking 
only. If subtasking is not included, 
the SIRB is queued to the TCB of the 
failing task.) 

The EXIT Routine 

This discussion of the EXIT routine 
includes only that part of its processing 
that affects the scheduling of user (asyn- 
chronous) exit routines. Other aspects of 
its processing are described under "Inter- 
ruption Supervision. " 

The EXIT routine deletes the scheduling 
performed by the three Exit Effectors. The 
EXIT routine is given control after a user 
exit routine has issued a RETURN macro 
instruction. If there are no other 
requests (queue elements) for the user exit 
routine, the EXIT routine removes the IRB 
from its TCB (in MFT with subtasking, the 
SIRB is permanently queued to the system 
error task TCB) and frees the storage occu- 
pied by the IRB. The top IQE or RQE, 
representing a request for the user exit 
routine, is removed from the IRB's list of 
queue elements since the request has been 
satisfied. If there is a list of available 
unscheduled queue elements, the EXIT rou- 
tine returns the removed element to the 
"available™ list. If, however, another 
element remains on the RB's queue, repre- 
senting an additional request for the asyn- 
chronous exit routine, the EXIT routine 
prepares for future reentry to the user 
exit routine and does not remove the RB 
from its TCB. In all cases except the 
last, the EXIT routine branches to the 
Transient Area Refresh routine. If the 
asynchronous exit routine must be reentered 
for another request, the EXIT routine 
branches to the Dispatcher. 
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TERMINATION SERVICES 



Termination Services provide the final 
processing necessary for programs that have 
normally or abnormally completed execution. 
The ABTERM routines schedule abnormal ter- 
mination; the ABEND routines actually ter- 
minate the task or subtask; the ABEND/STAE 
Interface routines schedule a user speci- 
fied routine to handle program errors; the 
Damage Assessment routines attempt to re- 
cover from certain errors; and the ABDUMP 
routines provide the programmer with a pic- 
ture of storage so that he may trace any 
problems within the program. 



ABNORMAL TERMINATION SCHEDULING 

ABTERM is used by a type 1 SVC routine 
to terminate the currently dispatched task 
and by any SVC routine to terminate a task 
that is not the currently dispatched task. 
ABTERM forces the specified task to termi- 
nate abnormally by replacing the address of 
the next sequential instruction, in the 
right half of the PSW, with the address of 
an SVC 13 (ABEND) instruction. It stores 
the completion code, sets the terminating 
task for immediate dispatching, and returns 
to the caller. 



NORMAL AND ABNORMAL TERMINATION 

Both normal and abnormal termination are 
performed by the ABEND modules. Essential- 
ly, the ABEND modules remove either a com- 
pleted program or a program unable to con- 
tinue processing because of an error. The 
modules then reinitialize the system to 
prepare it for the next task. All control 
blocks associated with the terminating pro- 
gram are purged, all outstanding I/O is 
halted, and the partition in which the pro- 
gram was located is made available for the 
next job. 

ABEND is a type 4 SVC routine that per- 
forms both normal and abnormal task ter- 
mination by freeing the resources and con- 
trol blocks associated with the terminating 
task. The freed resources thus become 
available for use by other tasks in the 
system. The control blocks affected are: 

• Task Control Blocks (TCBs) 

• Data Extent Blocks (DEBs) 

• Free Queue Elements (FQEs) 

• Request Blocks (RBs) 



• Interrupt Queue Elements (IQEs) 
© Timer Queue Elements (TQEs) 

• Gotten Subtask Area Queue Elements 
(GQEs) 

• Program Interrupt Elements (PIEs) 

ABEND can be entered directly from the 
problem program or system task via an ABEND 
macro instruction, which expands to include 
an SVC 13 instruction, or indirectly 
through the ABTERM service routine (see 
"Abnormal Termination Scheduling" above)* 
The SVC SLIH causes the first load module 
of ABEND (IEANTMOO) to be brought into the 
SVC transient area and passes control to 
it. Control is passed between ABEND 
modules using XCTL macro instructions (SVC 
7). 

ABEND processing varies depending on the 
type of termination (normal or abnormal) , 
the type of task terminating (job step or 
subtask), options included in the system, 
conditions causing the termination, and 
conditions arising within ABEND during pro- 
cessing (macro failures, etc.). The fol- 
lowing paragraphs describe the normal and 
abnormal task termination functions of 
ABEND. For a more detailed description of 
ABEND processing, refer to the module 
descriptions in Section 3. 



Normal Termination 

ABEND stores the normal completion code 
of the terminating task in the TCBCMP field 
in the TCB of the terminating task. If the 
system has an interval timer, the IQE 
pointer in the TQE is cleared. If the TQE 
is in use, a TTIMER macro instruction is 
used to cancel the timer. If a job-step 
task is terminating, ABEND closes all data 
sets whose DCBs are queued to the TCB, 
purges any unended MIWTO and WTOR requests, 
and dequeues all IQEs associated with the 
task. All main storage within the parti- 
tion, except that for a dummy program, is 
freed. 

ABEND returns control to the job manage- 
ment Step Deletion routines GO (IEFSD515) 
or SMALLGO (IEFSD599) by constructing a 
dummy program at the beginning of the par- 
tition. This dummy program contains an 
LPSW instruction followed by an XCTL macro 
instruction specifying the name of the job 
management routine that is to receive con- 
trol. The dummy program" s PRB is placed at 
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the beginning of the RB queue on the TCB, 
and ABEND branches to the dummy program. 

If the terminating task is the Online 
Text Executive Program (OLTEP) and the 
software and/or hardware involved in test- 
ing has not been reset, ABEND issues an SVC 
59 for performance of the cleanup functions 
necessary for system restoration. (See 
Online Test Executive Program . ) 

If the terminating task is a subtask, 
the IQEs for the task are purged, open data 
sets are closed, all gotten subtask area 
queue elements are dequeued and the area 
they describe is freed, and all request 
blocks, except the SVRB for ABEND, are 
removed from the active RB queue. ABEND 
sets the current task nondispatchable and 
issues an SVC 3 (EXIT) instruction. 

Abnormal Termination 

ABEND first determines whether SVC DUMP 
was in progress when the failure occurred. 
If so, ABEND clears the CVT lock byte, sets 
all tasks dispatchable, and reactivates the 
trace table or GTF. 

ABEND next tests for a Damage Assessment 
Routine recursion and, if found, exits to 
the DAR service routines. If a subtask is 
terminating and an invalid recursion has 
occurred, ABTERM is used to terminate the 
job step and a WAIT macro instruction is 
issued to allow immediate termination of 
the job step. 

If a CLOSE, OPEN, ABDUMP, or message 
recursion (WTO failure) has occurred, ABEND 
halts all I/O operations for this task and 
dequeues all request blocks created as a 
result of the recursion. Processing con- 
tinues with the test for dump (below) . 

If this is a nonrecursive termination, 
ABEND determines if STAE processing should 
be initiated. If so, ABEND exits to the 
ABEND/STAE interface routines. If ABEND 
was invoked because the purge failed during 
STAE processing, this same exit is taken. 
If no STAE processing is indicated, ABEND 
purges IQEs, active TQEs, and transient 
area requests for the terminal ng task and 
any of its subtasks. Unended MLWTO and 
WTOR requests are purged, I/O is halted, 
and control blocks are checked to ensure 
validity. 

ABEND determines if a dump is requested 
and what type of dump is wanted. It 
ensures that sufficient main storage is 
available for the dump by using a condi- 
tional GETMAIN macro instruction. If 
necessary, the programs described by the 
load list and active RB chain are freed to 
obtain this main storage. ABEND searches 
the TIOT for a SYSABEND or a SYSUDUMP DD 



name. If neither are found and the ter- 
minating task is a job- step task, ABEND 
stores pertinent information in main 
storage for eventual printing by the job 
management routines. This is called an 
indicative dump. (For a detailed descrip- 
tion of the indicative dump, see the Pro- 
grammer's Guide to Debugging .) If a SYS- 
ABEND entry is found as the last entry in 
the TIOT, ABEND opens a DCB for the dump 
data set if necessary and calls ABDUMP to 
dump the nucleus, the system queue area, 
and that area within the task's partition 
that is not free. If a SYSUDUMP entry is 
found, ABEND opens a DCB for the dump data 
set if necessary and calls ABDUMP to dump 
only that area within the task's partition 
that is not free. 

Upon completion of the dump, or if no 
dump was given, ABEND determines the type 
of task that is terminating. If the task 
is a job-step task with no subtasks, ABEND 
closes all data sets associated with the 
task, dequeues IQEs, and clears the point- 
ers to the ABEND appendages and transient 
area queues. ABEND exits to the job mana- 
gement routines to print the indicative 
dump if necessary and to initiate the next 
task. 

If the terminating task is itself a sub- 
task, ABEND frees IQEs for the terminating 
task and any subtasks, chains all subtask 
data sets to the TCB of the current task, 
dequeues subtask TCBs from the ready queue, 
and frees the associated main storage. 

If the terminating task is a job step 
task with subtasks having no outstanding 
ENQ requests, ABEND purges resources for 
its subtasks, and processing continues as 
for a job step without subtasks (above) . 

If the terminating task is a job-step 
task with subtasks having outstanding ENQ 
requests, ABEND dequeues them. 

If the terminating task is the Online 
Test Executive Program (OLTEP) and the 
software and/or hardware involved in test- 
ing has not been reset, ABEND issues an SVC 
59 for performance of the cleanup functions 
necessary for system restoration. (See 
Online Test Executive Program . ) 

In all cases, the Message Information 
List that is maintained in the nucleus and 
in which Type-1 SVCs can store data about 
the cause of an abnormal termination of a 
Type-1 SVC is searched for a matching TCB. 
If an entry is found, ABEND writes out the 
message. 

Data sets queued to the TCB of the ter- 
minating task are closed, subtask resources 
are purged, and the reguest block queue 
from the TCB is terminated leaving only the 
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SVRB for ABEND. The sub-task is set nondis- 
patchable, and ABEND issues an SVC 3 (EXIT) 
instruction. 



STAE SCHEDULING AND PROCESSING 

The STAE routine is a type 3 SVC routine 
that prepares a user- specified exit routine 
to intercept abnormal termination proces- 
sing. When the user's task becomes sched- 
uled for abnormal termination, the ABEND/ 
STAE interface routine (ASIR) is given con- 
trol by ABEND. ASIR purges all active I/O 
for the task (unless PURGE=NONE) and gives 
control to the user- provided exit routine. 
Upon regaining control, ASIR returns con- 
trol to ABEND for completion of termina- 
tion, unless the user has specified that a 
STAE Retry routine is to be scheduled. 

If retry is to be scheduled with a purge 
of the RB chain, all RBs between the RB 
associated with the current STAE and the 
RBassociated with ABEND are purged. All 
data sets related to the purged RBs are 
closed, the resume PSW of the RB using STAE 
is set to point to the retry routine, and 
control is passed to the Dispatcher to 
initiate the retry. 

For a retry with no purge (system tasks 
only) , an RB is created for the Retry rou- 
tine and control is passed to the dispatch- 
er to initiate the retry. 



DAMAGE ASSESSMENT 

The Damage Assessment Routine (DAR) is 
invoked by ABEND to attempt to recover from 
the following: 



o Failures within system tasks. 

© Failures within tasks in the "must com- 
plete" status. 

© Invalid recursions within the termina- 
tion process. 

DAR 1 (IEADTM22) provides a dump of main 
storage (as it was at the time of the fail- 
ure) to the SYS1.DUMP data set by issuing 
an SVC 51 instruction. DAR 2 (IEADTM23) 
attempts to reinstate failing system tasks 
that are not in "must complete" status. 
DAR 3 (IEADTM24) attempts to reinstate all 
other tasks. If the task is in the "must 
complete" status and resources are not 
critical, a task reinstatement message is 
issued and control is passed to ABEND 3 to 
continue termination processing. If 
resources are critical, or if the entry to 
DAR 3 is a recursion, DAR 4 sets the task 
nondispatchable and control is given to the 
Dispatcher for the next highest priority 
ready task. Messages are written to the 
console to inform the operator of the sta- 
tus of DAR at various points during its 
operation. 



DUMPING 

The ABDUMP routine (SVC 51) produces a 
dump of system and problem- program informa- 
tion. ABEND or a user may invoke ABDUMP by 
issuing a SNAP macro instruction to dump 
the major control blocks, save areas, and 
main storage. If Main Storage Hierarchy 
Support is in the system, ABDUMP dumps the 
main storage hierarchies (0 or 1 or both) 
associated with the calling task. 
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CONTENTS SUPERVISION 



The services of contents supervision are 
loading a program into main storage, sched- 
uling its execution , and deleting it from 
main storage. Contents supervision also 
keeps records of all programs that reside 
in main storage so that access may be 
gained to any program. 



CONTENTS SUPERVISION ROUTINES 

The contents supervision routines record 
the identity, main-storage location, size, 
and attributes of programs as they are 
brought into main storage. Programs that 
are no longer needed are released automat- 
ically by the EXIT routine (see "Interrup- 
tion Supervision") or, if brought into main 
storage by a LOAD macro instruction, are 
released by a DELETE macro instruction. 
Contents supervision routines maintain 
queues of request blocks to identify the 
different types of routines and by which 
tasks they may be accessed. Following are 
the contents supervision routines: 

ATTACH (MFT without subtaskinq) : In sys- 
tems without subtasking, the ATTACH routine 
provides compatibility with systems with 
the subtasking option. The contents super- 
vision ATTACH routine provides linkage to a 
specified program (see LINK), but does not 
create a new TCB nor does it allow for 
asynchronous processing. 

LINK : This routine provides linkage from 
the routine that issued the LINK macro 
instruction to another routine. When the 
called routine finishes processing, control 
is returned by the Dispatcher to the next 
sequential instruction following the LINK 
macro instruction in the calling routine. 

LOAD : This routine ensures that a copy of 
a specified routine exists in main storage 
and returns the address of the routine to 
the requester. 

XCTL : This routine passes control from the 
caller to the requested routine. The cal- 
ling routine is released from main storage 
and will not regain control. 

FINCH : This routine is used by the super- 
visor to schedule the loading of programs 
into main storage. It also contains the 
Transient Area Loading Task. 

IDENTIFY : This routine allows the caller 
to dynamically specify an entry point name 
in a load module so that the caller may 



issue LINK and XCTL macro instruction to 
that identified entry point. 



DELETE: 



This routine releases modules from 



main storage which were brought in by LOAD. 

SYNCH : This routine passes control from 
the control program in supervisor state to 
a processing program in main storage, and 
provides return linkage to the control pro- 
gram in supervisor state. 



CONTENTS SUPERVISION FUNCTIONS 

The contents supervision routines keep 
records about program segments that are 
loaded, branched to, and released from main 
storage. Following are the functions of 
contents supervision: 

o Creating and maintaining request 
blocks. 

• Servicing requests for supervisor- 
assisted linkage. 

o Bringing modules into main storage. 

o Bringing modules into the SVC transient 
area. 

o Identifying embedded entry points. 

o Deleting a loaded module. 

o Synchronizing control program and prob- 
lem program execution. 

This section discusses contents supervi- 
sion by functional areas. For a more 
detailed description of the contents super- 
vision modules, see Section 3, "Program 
Organization. ■ 



CREATING AND MAINTAINING REQUEST BLOCKS 

Contents supervision creates a request 
block each time that a module is brought 
into main storage. Additional requests 
blocks are created for a module if a user 
requests a reenterable module that is being 
used by another program. Request blocks 
contain information required to schedule, 
execute, and terminate the program with 
which they are associated. (See Section 5 
for the format of the request blocks.) 
There are seven types of request blocks in 
MFT: 
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• Program Request Block (PRB) — repre- 
sents a non- supervisory routine that 
must be executed in the performance of 
a task. PRBs are created by LINK, 
SYNCH, and XCTL. 

• Supervisor Request Block (SVRB) — 
represents a supervisor routine to be 
executed at the request of a system or 
user task. SVRBs are created by the 
Supervisor Call Second-Level Interrup- 
tion Handler (SVC SLIH) for its own use 
and at the request of the Dispatcher. 

• Interruption Request Block (IRB) — 
represents a routine that must be 
executed in the event of an asynch- 
ronous interruption. IRBs are created 
before the interruption occurs, but are 
not placed on a queue until after the 
interruption occurs. 

• System Interruption Request Block 
(SIRB) — is used only for the system 
I/O error task. There is only one SIRB 
in the system, and is always fixed in 
the nucleus regardless of whether it is 
queued to a TCB. 

• Loaded Program Request Block (LPRB) — 
represents programs brought into main 
storage by LOAD. An LPRB is designated 
as a "dummy" when it is queued to the 
Loaded Program List or Job Pack Area 
Queue and is a copy of an LPRB that 
represents a module in the Resident 
Reenterable Module Area. An LPRB is 
designated as "minor" when it repre- 
sents a control section of a program 
specified by an IDENTIFY macro instruc- 
tion. LPRBs are created by LOAD, LINK, 
XCTL, and IDENTIFY. 

• Loaded Request Block (LRB) — repre- 
sents modules that have the "load only" 
attribute. These modules can gain con- 
trol only by a branch, not a LINK, 
XCTL, or ATTACH macro instruction. 
LRBs are created by LOAD. 

• FINCH Request Block (FRB, present only 
in MFT with subtasking) — represents 
programs that are in the process of 
being loaded by LOAD. An FRB is 
created upon entry to the LOAD routine, 
and is deleted upon completion of the 
LOAD processing. 

The Request Block Queues 

The supervisor maintains the attributes 
of and relationships between modules by 
placing their associated request blocks on 
appropriate queues. Maintaining these RBs 
facilitates loading, locating, passing con- 
trol to, and deleting the modules. Thus, 
related modules will be executed in proper 
sequence, and control passed correctly 



between them. Normally, a request block is 
physically located immediately before its 
module in main storage. Logically, a re- 
quest block is located on one or more of 
the following queues: 

Active Request Block Queue ; There is one 
active RB queue for each job step or sub- 
task task control block (TCB) in the sys- 
tem. The first (top) RB on the queue is 
pointed to by the TCBRBP field in the TCB, 
and represents the module that is currently 
being executed for the task. This queue 
may have PRBs, IRBs, SVRBs, LPRBs, and the 
SIRB on it. (In MFT with subtasking, the 
SIRB is queued only to the System Error 
Task TCB. In MFT without subtasking, the 
SIRB will be queued to the TCB representing 
the task that had an I/O error.) At any 
point during execution of the task, the 
active RB queue will have on it an RB for 
each module that has not completed execu- 
tion for the task. The relationship 
between RBs on this queue is maintained 
through the use of the XRBLNK field in each 
RB. Request blocks are added to the top of 
the queue so that each XRBLNK field points 
to the RB for the module that will receive 
control when this module has finished pro- 
cessing. Where LINK or ATTACH routines are 
used, processing occurs in a first-in, 
last-out manner (that is, the RB for the 
issuing program is pushed down on the 
queue) . Where an XCTL macro instruction is 
used, the RB for the issuing program is 
removed from the queue so that the issuing 
program cannot regain control. 

Loaded Program List ; This queue also orig- 
inates in the TCB for the job step or sub- 
task and is pointed to by the TCBLLS field. 
The order of RBs on this queue is the order 
in which the modules were brought into main 
storage. The Loaded Program List contains 
LRBs, LPRBs, dummy LPRBs, and all minor 
LPRBs. All modules which are represented 
on this queue are assumed to be serially 
reusable and may be used only by the task 
in whose TCB the list originates. In MFT 
without subtasking, all modules that are 
brought into main storage by LOAD will have 
an associated LRB or LPRB on this queue. 
In MFT with subtasking, only those modules 
that are not reenterable are represented on 
this queue (by LPRBs). Because modules 
represented by LRBs are always reenterable, 
they will be represented on the Job Pack 
Area Queue, not the Loaded Program List. 

Job Pack Area Queue (MFT with subtasking 
only) : This queue is similar to the Loaded 
Program List in that only modules brought 
into main storage by LOAD are represented. 
However, the LRBs and LPRBs represent only 
those modules that are reenterable. Minor 
LPRBs are never placed on this queue. FRBs 
are found only on this queue, and they 
exist only while the module is being loaded 
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into main storage. The Job Pack Area Queue 
is pointed to by the Partition Information 
Block (PIB+X^D*) which is pointed to by 
each TCB in the partition. Modules repre- 
sented on this queue may be used by any 
task in the partition. 

Resident Reenterable Module Area Queue 
(optional) : If this option is included in 
the system, the Nucleus Initialization Pro- 
gram identifies those programs that are 
permanently resident in main storage by 
creating a queue of LPRBs. This queue is 
pointed to by the CVTLPAQ field in the Com- 
munication Vector Table. Modules on this 
queue are always reenterable and may be 
used by any task in the system.. The use of 
any of these modules results in the crea- 
tion of a dummy LPRB which, for LINK, 
ATTACH, or XCTL requests, is queued to the 
Active Request Block Queue of the TCB for 
the requesting task or, for a LOAD request, 
to the Job Pack Area Queue. 

Resident SVC Queue (optional) : This queue 
contains LPRBs for SVC modules that have 
been made resident by the use of the RSVC 
option. The queue is pointed to by 
IEAARSV1 within module IEAATCOO. 

Resident Access Methods Queue (optional) ; 
This queue contains LPRBs for access method 
modules that have been made resident by use 
of the RAM option. The queue is pointed to 
by IEAARAM4 within module IEAATCOO. 



SERVICING REQUESTS FOR SUPERVISOR-ASSISTED 
LINKAGE 

Contents supervision services requests 
for supervisor-assisted linkage by: 

• Searching for the requested module. 

• Determining whether the module is 
available. 

• Bringing the module into main storage. 

• Deferring a request for the module. 

• Scheduling execution of the module. 

Initialization and input processing are 
dependent upon the type of request. The 
requests are serviced by the ATTACH, LINK, 
LOAD, XCTL, and FINCH service routines. 

Searching for a Requested Module 

Upon receiving a request for supervisor- 
assisted linkage, contents supervision 
searches for the specified module in the 
Job Pack Area Queue (applicable only to MFT 
systems with subtasking) , the Loaded Pro- 
gram List, and the Resident Reenterable 
Module Area (if included in the system). 



The search of these queues is terminated 
when a request block representing an avail- 
able copy of the module is found. 



Determining the Module's Availability 

A module is available if it is in main 
storage and not in use. If an available 
copy is found, control is passed to the 
module for the XCTL, LINK, and ATTACH func- 
tions, or the address of the module is 
returned to the requester by the LOAD func- 
tion. If the requested module is not 
found, or is found but is in use, another 
copy of the module is brought into main 
storage for that request. In MFT with sub- 
tasking, the request for a module may be 
deferred if another request has been made 
for the module, but the module has not been 
brought into main storage (see "Deferring a 
Request for a Module") . 

Bringing A Module Into Main Storage 

If, in response to a LINK, LOAD, XCTL, 
or ATTACH request, the supervisor does not 
find a usable copy of the module in main 
storage, the subroutine FINCH is entered to 
prepare for the loading of the module by 
Program Fetch. The FINCH subroutine uses 
the directory entry supplied by the caller 
or obtained by the data management BLDL 
routine to determine the amount of main 
storage needed to contain the module and 
its request block. FINCH obtains that 
amount of main storage in the appropriate 
location and uses Program Fetch to bring 
the module into main storage or brings it 
into the transient area. FINCH initializes 
the request block and returns control to 
the routine that branched to FINCH. 

Use of the "PANIC", a Fixed Work Area in 
FINCH 

Program Fetch requires that FINCH pro- 
vide a parameter list containing informa- 
tion necessary to bring the requested 
module into main storage. FINCH issues a 
conditional SVC 4 (GETMAIN) instruction to 
obtain main storage for the parameter list. 
If sufficient main storage is not available 
and the request is to load a module into 
the SVC or I/O error transient areas, FINCH 
uses a fixed- length work area called the 
PANIC. When FINCH processes a request to 
load a module from the SYS1.SVCLIB, the 
PANIC is always used. 

While the PANIC is being used, the sys- 
tem is "pseudo-disabled," preventing entry 
to the Dispatcher (see "Pseudo-disabled 
Interruption Supervision" in Section 2). 
When Program Fetch returns control to 
FINCH, the system is pseudo- enabled, allow- 
ing use of the PANIC during the processing 
of subsequent requests. 



Contents Supervision 35 



Deferring a Request for a Module 

In MFT with subt asking , a LOAD macro 
instruction requires special processing. 
When LOAD determines that the requested 
module is not in main storage , it creates a 
FINCH Request Block (FRB) and places it on 
the Job Pack Area Queue to indicate that 
the module is being loaded. If another re- 
quest for the same module is received while 
the module is being loaded to satisfy the 
first request, a second copy of the same 
module is not loaded. Instead, LOAD finds 
the FRB for the module on the Job Pack Area 
Queue, creates a Wait List Element (WLE) , 
and queues it on the FRB. The routine that 
issued the second request is placed in a 
wait state pending completion of the load- 
ing. When the module has been completely 
loaded into main storage, the FRB is 
removed from the Job Pack Area Queue, the 
request block for the module is placed on 
the appropriate queue, and all requests 
represented by WLEs are set dispatchable. 
LOAD is reentered for the second request 
and the Job Pack Area Queue is searched 
again. If the loaded module is reenter- 
able, it is represented on the Job Pack 
Area Queue by an LPRB. LOAD returns the 
address of the routine to the requester. 
If the loaded module is not reenterable 
(not queued on the Job Pack Area Queue) , an 
FRB is again created and queued to the Job 
Pack Area Queue, and a new copy of the 
module is brought into main storage. 

Scheduling the Execution of a Module 



High 




Figure 15. Control Block Queue after a 
Load and Link 



the completion of the requested routine. 
If the user specified an end-of-task exit 
routine (ETXR), ATTACH builds and initial- 
izes an interruption request block (IRB) 
and queues it between the RB for the re- 
questing program and the SVRB for ATTACH. 
When the attached routine exits, the end- 
of-task exit routine gains control. 



The supervisor schedules the execution 
of a requested program for ATTACH, LINK, 
and XCTL macro instructions by placing the 
request block of the module on the top of 
the active request block queue. The Dis- 
patcher gives control to the module when 
its RB is the top RB on the queue and its 
TCB represents the highest priority ready 
task. When the module exits, its RB is 
removed from the queue. If the module was 
invoked by an ATTACH or LINK macro instruc- 
tion, control returns to the caller at the 
instruction following the LINK or ATTACH 
macro instruction. If invoked by an XCTL 
macro instruction, control does not return 
to the caller because its RB was removed 
from the active RB queue by XCTL. Figure 
15 illustrates the active RB queue after 
Program A has issued LOAD and LINK macro 
instructions, each specifying the nonreen- 
terable Program B. 

Special ATTACH Processing 

Although the ATTACH routine (MFT without 
subtasking) does not create a new task, it 
must perform certain additional functions 
to be compatible with the subtasking ATTACH 
routine. If the user specified an ECB 
parameter, ATTACH posts the ECB to indicate 



THE TRANSIENT AREAS 

The transient areas are two 1024-byte 
areas within module IEAATCOO (LINK, LOAD, 
XCTL, FINCH) into which I/O error handling 
and non-resident SVC routines are tem- 
porarily loaded for execution. These areas 
provide economy of main storage for rou- 
tines that are less frequently executed 
than other control program routines. 

Fetching a Module into the SVC Transient 
Areas 

The SVC transient area is loaded by the 
FINCH routine and the transient area load- 
ing task. FINCH creates and initializes 
the parameter list necessary for the tran- 
sient area loading task, places the re- 
questing SVRB on the transient area request 
queue, and sets that SVRB to a wait condi- 
tion. If the transient area is not cur- 
rently being loaded, FINCH indicates to the 
transient area loading task the routine to 
be loaded, removes the SVRB for the tran- 
sient area loading task from the wait con- 
dition, and branches to the Dispatcher. If 
the transient area is being loaded, FINCH 
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does not indicate that this routine is to 
be loaded, but branches to the Dispatcher. 

The transient area loading task is the 
highest priority task in the system. Its 
task control block (TCB) is created at sys- 
tem generation with an SVRB in a wait con- 
dition as the only request block on its RB 
queue. When the SVRB is removed from the 
wait condition by FINCH r the transient area 
loading task gains control from the dis- 
patcher. Although the loading of a module 
into the transient area may be interrupted , 
the module will be completely loaded before 
any other, higher priority request for the 
transient area will be performed. When the 
module is completely loaded, the transient 
area loading task removes all SVRBs from 
the transient area request queue, removes 
these SVRBs from the wait condition, and 
exits to the dispatcher. 

The transient area request queue, which 
originates in FINCH, is a chain of SVRBs 
representing requests for nonresident SVC 
routines that are to be loaded into and 
executed in the transient area. The chain 
is created and maintained by FINCH and the 
transient area loading task using the two 
fullword pointers in the boundary boxes 
associated with the TCBs. (Figure 16 illu- 
strates multiple requests for the transient 
area. See Section 5 for the format of the 
boundary box.) The fullword at boundary 
box- 16 is a pointer to the boundary box 
(-16) for the previous outstanding request 
for the transient area. The fullword at 
boundary box-12 is a pointer to the SVRB 
for the last request for the transient area 
for that task. The transient area queue 
exists only while a module is being loaded; 
the transient area loading task purges the 
queue so that the SVRBs may contend for the 
transient area task by priority. 

It is possible for a task to have a re- 
quest on the queue waiting for the tran- 
sient area to be loaded and yet issue 
another request for loading the transient 
area. An example of this is an Interrup- 
tion Request Block (IRB) which is scheduled 
for execution and is queued immediately 
following the SVRB waiting on the transient 
area. If the program represented by the 
IRB issues a request for a type 3 or 4 non- 
resident SVC routine, the first request is 
dequeued and taken out of the wait state so 
that the most recent request will be queued 
and put into the wait. The previous re- 
questing SVRB is no longer the active RB 
and will not regain control until the next 



request has finished using the transient 

area. 



IDENTIFYING EMBEDDED ENTRY POINTS 

The IDENTIFY function is an optional 
supervisory feature that may be selected 
during system generation. If this option 
is not selected, the IDENTIFY is treated as 
a NOP instruction. 

The IDENTIFY routine IEAAIDOO builds a 
minor LPRB describing the embedded entry 
point of a routine that already resides in 
main storage. IDENTIFY places this RB in 
the Loaded Program List so that the 
embedded routine can be found by the super- 
visor and can then be accessed using 
supervisor-assisted linkages (LINK and 
XCTL) . 



DELETING A LOADED MODULE 

The DELETE routine removes modules that 
have been brought into main storage by a 
LOAD macro instruction. DELETE searches 
the Resident Access Method (RAM) List 
(optional) , the Job Pack Area Queue (MFT 
with subtasking only), and the Loaded Pro- 
gram List for the request block represent- 
ing the module to be deleted. If the re- 
quest block is not found, DELETE indicates 
this by a return code and issues an SVC 3 
(EXIT) instruction. If the RB is found on 
the RAM list, DELETE returns via a BR 14. 
If the request block is found elsewhere, 
its use count is decremented. If the use 
count is and the module is inactive, 
DELETE frees the area of the module and its 
request block. The DELETE routine then 
issues an SVC 3 (EXIT) instruction. 



SYNCHRONIZING CONTROL PROGRAM AND PROBLEM 
PROGRAM EXECUTION 

When the control program executing in 
supervisor state is to give control to a 
problem program (executing in nonsupervisor 
state) , and control is to return to the 
control program for further execution in 
the supervisor state, the control program 
issues a SYNCH macro instruction. This 
expands to include an SVC 12 instruction. 
The SYNCH routine builds a program request 
block in the lower area of the partition 
and places the PRB on the active RB queue 
immediately after the SVRB for SYNCH. 
SYNCH issues an SVC 3 (EXIT) instruction. 



Contents Supervision 37 



Problem Program TCBs 
and Boundary Boxes 



TCB/RB Queue 




f REQ3 



'TAQUE', which is located in 
FINCH, is the head of the 
transient area request queue. 
The shaded areas located at a 
displacement of 4 full words 
before the boundary boxes of 
each TCB represent the rest of 
the transient area request queue 
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Figure 16. Transient Area Request Queue and TCB/RCB Queue 
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MAIN STORAGE SUPERVISION 



The Main Storage Supervision routine 
(GETMAIN/FREEMAIN) controls the allocation 
and release of all dynamic main storage and 
of the system queue area (SQA) - 



MAIN STORAGE 

Each partition in the dynamic area has 
an associated TCB which contains a pointer 
to the main storage boundary box for that 
partition. This box defines the limits of 
each partition. (See Section 5 for the 
format of the boundary box. ) 

Dynamic main storage may be expanded by 
including IBM 2361 Core Storage in the sys- 
tem. If 2361 Core Storage and its program- 
ming support (Main Storage Hierarchy Sup- 
port) are included in the system, the 
dynamic area is divided into two parts: 
processor storage (hierarchy 0) and 2361 
Core Storage (hierarchy 1). The request 
for main storage allocation may specify 
either hierarchy. If space is not available 
in hierarchy 1, it will be allocated from 
hierarchy f regardless of the hierarchy 
specified in the GETMAIN macro instruction. 

The routine IEAAMS, in response to a 
GETMAIN macro instruction, obtains storage 
from either the problem program partition 
or, if a system task issued a GETMAIN macro 
instruction specifying subpool 245 or 255, 
from the SQA. This area is used for system 
control blocks that might be destroyed by 
problem programs if they were placed in 
problem partitions. The boundary box for 
the SQA is in the master scheduler resident 
data area (offset X , 64'). This area is 
addressed by the CVTMSER field in the Com- 
munications Vector Table. 

The system tasks that request space from 
the SQA are: 

• The CSCB (Command Scheduling Control 
Block) creation module of SVC 34 for 
CSCBs. 

• The task supervision ATTACH routine for 
subtask TCBs, if the subtasking option 
is included in the system. 

• The ENQ/DEQ processing routine of task 
supervision, for all control blocks 
associated with ENQ/DEQ. 

• The communications task, for write-to- 
operator (WTO) buffers if no WTO buffer 
storage space specified during system 
generation is available. 



GETMAIN 

All requests for space within dynamic 
storage or the SQA are handled by GETMAIN. 
To find an area of free main storage large 
enough to fulfill the request, GETMAIN 
searches the Free Area Queue in the parti- 
tion issuing the request. Each Free Area 
Queue Element (FQE) occupies the first two 
fullwords in the free area described and 
contains a pointer to the FQE describing 
the next lower free area within the parti- 
tion or f s if it describes the lowest free 
area. The second word contains the length 
in bytes of the free area it describes. 
The boundary box for the partition points 
to the FQE for the highest free area. Each 
FQE begins and ends on a doubleword boun- 
dary, and requests for main storage are 
always rounded-up to a doubleword boundary. 
If the address, after rounding- up, does not 
fit in three bytes, the requester will be 
abnormally terminated. 
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Although subpools are not created in 
MFT, tasks may specify subpool numbers in 
the GETMAIN macro instruction. When a 
problem program issues a GETMAIN macro 
instruction specifying a subpool from 
through 127, storage is allocated from the 
high-address portion of the partition in 
which the GETMAIN macro instruction was 
issued. When a problem program attempts to 
issue a GETMAIN macro instruction specify- 
ing any other subpool, the program is 
abnormally terminated. 

When a system task issues a GETMAIN 
macro instruction specifying a subpool from 
through 127, storage is allocated from 
the low-address protion of the partition; 
when the macro instruction specifies a sub- 
pool from 128 through 244 or 246 through 
254, storage is allocated from the high- 
address portion of the partition. Subpools 
245 and 255 are handled as a special case 
as described above. 

The GETMAIN macro instruction can either 
be conditional or unconditional. If an 
unconditional request cannot be satisfied, 
the requesting task is abnormally ter- 
minated. However, before scheduling the 
task for termination, GETMAIN determines if 
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ABEND or the SVC SLIH was the requester. 
If so, abnormal termination is not sched- 
uled. Instead an error code is returned to 
the caller. This action prevents a loop 
that could be caused by rescheduling an 
abnormal termination for a task. 

If space cannot be found to satisfy a 
conditional request, a return code is 
placed in register 15 , and control is 
returned to the caller. 

If enough space is found, the address of 
the allocated space is returned to the 
caller. If the space allocated is less 
than that described by the FQE, the length 
indicator in the FQE is adjusted to reflect 
the new size of the free area. If the 
entire free space is allocated, the FQE is 
removed from the queue. 

Processing with the Subtaskinq Option 

If the subtasking option is included in 
the system, the GETMAIN routine creates a 
gotten subtask area queue to describe the 
main storage obtained for a subtask by a 
system-issued GETMAIN macro instruction. 
For example, if a subtask issues a LINK 
macro instruction for a module that is not 
in main storage, LINK processing in turn 
issues a GETMAIN macro instruction for 
space in the partition within which the 
requested module will execute. GETMAIN 
adds eight bytes to the requested size, 
creates a gotten subtask area queue element 
(GQE) within those eight bytes, queues the 
GQE, and returns the address of the avail- 
able area (GQE+8) to the requesting rou- 
tine. The first word of a GQE is the 
address of the previously created GQE or 
if this is the first GQE, and the second 
word is the length of the allocated area. 
The queue of GQEs originates in the first 



word of the boundary box pointed to by the 
TCBMSS field in the subtask TCB. GQEs are 
added to the top of the queue as they are 
created. The order of GQEs indicates only 
the order in which main storage was 
obtained for the subtask, not the relative 
physical locations of their associated 
areas within the partition. The GQE on the 
bottom of the queue is always associated 
with the register save area obtained for 
the subtask. The next to last GQE will 
describe the area in which the subtask 
itself is executing, providing the subtask 
was not resident and inactive in main 
storage when the ATTACH macro instruction 
was issued. 

Special ATTACH Processing 

When the ATTACH routine issues a GETMAIN 
macro instruction, it specifies a length 8 
bytes greater than the size of the module. 
In this case, ATTACH, not GETMAIN . creates 
the GQE and places it on the subtask 1 s GQE 
queue. 



FREEMAIN 

All requests to release space in the 
dynamic areas or in the SQA are handled by 
FREEMAIN. FREEMAIN makes the space pre- 
viously allocated by GETMAIN available for 
reallocation by modifying an existing FQE, 
or by creating a new FQE and adding it to 
the Free Area Queue. 

When a subtask terminates, the normal or 
abnormal termination routines refer to the 
GQEs chained to the subtask' s TCB in order 
to free the main storage belonging to the 
terminating subtask. The GQEs are removed 
from the queue whenever the subtask storage 
space is freed. 
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COMMUNICATIONS TASK 



The communications task processes input 
and output between the central processing 
unit and one or more devices. Input 
results from an unplanned interruption from 
an external device or from the main con- 
sole; output results from the WTO (Write to 
Operator) and WTOR (Write to Operator with 
Reply) macro instructions. 



INPUT PROCESSING 

The operator causes an I/O interruption 
by pressing the REQUEST key or START key on 
an I/O device. The I/O jFirst-Level Inter- 
ruption Handler passes control to the I/O 
Supervisor which determines that an I/O 
interruption from the operator has 
occurred. Control then passes to the resi- 
dent I/O Attention Handier (IEECVCRA) which 
posts the attention ECB in the Unit Control 
Module. 

When the operator presses the INTERRUPT 
key on an operator control panel, he causes 
an external interruption. In this case, 
control passes from the External First- 
Level Interruption Handler to the resident 
communication task External Interruption 
Handler (IEECVCRX) , which posts the extern- 
al ECB in the Unit Control module. Diagram 
14 illustrates input processing. 



OUTPUT PROCESSING 

Console output is initiated when a user 
or system program issues a WTO or WTOR 
macro instruction. These macro instruc- 
tions issue an SVC 35 instruction which 
causes the nonresident module IEENFWTO (or 
IEEMFWTO with MCS) to be brought into the 
SVC transient area. This module moves the 
message into a Write Queue Element (WQE) , 
places the WQE on the system output queue, 
and posts the WTO ECB. If a WTOR macro 
instruction is being processed, IEENFWTO 
passes control to the nonresident module 
IEEVWTOR to create and queue to the Unit 
Control Module a Reply Queue Element before 
moving the message text to the WQE. If 
routing code 11 is specified, IEENFWTO 
passes control to the nonresident Write-to- 
Programmer module, IEEWTPOO, before moving 
the message text. If this is a multiple- 
line WTO (MLWTO) , control is passed to 
IEECVML1 (non-MCS) or IEECVML3 (MCS). Dia- 
gram 15 illustrates output processing. 

Note ; If routing code 11 is the only rout- 
ing code specified for a WTO macro instruc- 
tion, the message will not appear at a con- 



sole, unless a console was specified at 
system generation to accept routing code 
11. 



COMMUNICATION TASK PROCESSING 

The communication task executes under 
its own TCB and is composed of several non- 
resident modules and the following three 
resident modules: the Initialization 
module, IEECVCTI, which creates control 
blocks and initializes the Unit Control 
Nodule at NIP; the nonexecutable Unit Con- 
trol Module, IEECVUCM, which contains 
storage areas, pointers, and the five event 
control blocks; and the communications task 
Wait module, IEECVCTW. The Wait module 
issues a WAIT macro instruction specifying 
a list of addresses (Event Indication List) 
of the external ECE, the attention ECB, the 
WTO ECB, RMS ECB, and I/O completion ECBs. 
When one of these ECBs is posted by initial 
input or output processing, the communica- 
tion task becomes a ready task and receives 
control when it becomes the highest priori- 
ty task in the system. The Wait module 
issues an SVC 72 instruction, which causes 
an SVRB to be built for the execution of 
nonresident modules, to pass control to the 
nonresident Router. Using the ECBs in the 
Unit Control Module and the I/O ECBs 
pointed to by the EIL, the Router deter- 
mines the cause of entry to the communica- 
tions task and passes control to a nonresi- 
dent module to service the interruption. 

External interruptions are serviced by 
the external interruption processor module, 
IEECVCTX, which performs the console 
switch. I/O, attention, and WTO interrup- 
tions are serviced by the device processor 
module which execute channel programs to 
read from or write to a device (or both) , 
and the open/close device support routines. 



MULTIPLE CONSOLE COMMUNICATIONS 

The Multiple Console Support (MCS) rou- 
tines handle I/O for up to 32 system opera- 
tor consoles. Input follows from an atten- 
tion (I/O interruption) from an active con- 
sole. Output results from a WTO or WTOR 
macro instruction in a problem program or 
in a system task. MCS also handles extern- 
al interruptions from the operator control 
panel, I/O complete conditions. Delete 
Operator Message (DOM) macro instructions, 
console switching, and system and console 
output queue management. 
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As in systems without MCS, control is 
routed by the External First- Level Inter- 
ruption Handler for external interruptions, 
and by the I/O First-Level Interruption 
Handler for console device attentions and 
I/O complete interruptions (see Diagram 
16). WTO, WTOR, and DOM macro instructions 
are handled by SVC 35 and SVC 87 respec- 
tively. The routing results in the posting 
of one of the 5 ECBs (RMS, external, atten- 
tion, WTO, DOM) in the Unit Control Module 
(UCM) , or the posting of one of the I/O 
ECBs pointed to by the Event Indication 
List (EIL) within the UCM. The communica- 
tions task TCB, created within the nucleus 
at system generation, is then indicated as 
ready. The Dispatcher passes control to 
the communications task when its TCB is the 
highest priority TCB on the queue. 

In addition to the ECBs and the pointer 
to the EIL, the UCM contains pointers to 
the system output queue, the reply queue 
elements, and the UCM entries (see Figure 
17). At system generation, a UCM entry is 
constructed for each console device speci- 
fied by the SCHEDULR and SECONSLE macro 
instructions (a composite console will have 
2 UCM entries). Each UCM entry contains 
pointers to the processor module for that 
device, to the console output queue, and to 
the alternate console, and contains the 
routing codes and command authority codes 
assigned to the device. The console output 
queue is a series of pointers to selected 
WQEs on the system output queue. The first 
byte of each pointer indicates the status 
of the corresponding WQE in relation to the 
device. 

The communication task with MCS uses the 
non-MCS Initialization module, IEECVCTI; 
the Unit Control module, IEECVUCM; the 
Attention Handling module, IEECVCRA; the 
External Interruption Handling module, 
IEECVCRX; and the following MCS modules: 

• Mini-Router (IEECMCTR) , which receives 
control as a result of an SVC 72 
instruction issued by IEECMDSV, 
IEECMAWR, IEEC2740, or IEECMDOM. This 
SVC 72 causes an SVRB to be built for 
the execution of the device processors 
and other nonresident communications 
task modules. 

• Router (IEECMAWR) , which receives con- 
trol when one of the ECBs in the UCM is 
posted. It passes control to other 
communication task modules to service 
the interruptions and for queue 
management. 

• Console Switch (IEECLCTX, IEECMCTX, 
IEECNCTX, and IEECOCTX) , which switches 
consoles as a result of an external 
interruption, an unrecoverable I/O 
error, or a VARY command. 



• Device Service (IEECMDSV), which passes 
control through the Mini-Router to 
appropriate device processor modules 
when there is I/O to be performed, or 
consolidates system and console output 
queues. 

• WTO Service (IEECMWSV), which queues 
WQEs to console output queues. 

• DOM Service (IEECMDOM) , which indicates 
that specified operator messages can be 
deleted. 

• NIP Message Buffer Writer ( IEECMWTL) , 
which writes messages from the buffer 
created by the Nucleus Initialization 
Program. 



THE SYSTEM LOG FUNCTION 

In systems that include Multiple Console 
Support (MCS) , a hard copy of all operator 
and system messages is required when there 
is an active graphic console or more than 
one active non-graphic console. Because of 
this requirement, a system log function is 
provided which may be specified as the hard 
copy log. In MFT, the System Log operates 
under its own TCB created at system 
generation. 

The system log consists of two data sets 
cataloged at system generation on which 
critical system information is recorded. 
The existence of two data sets allows one 
(the primary data set) to receive data from 
the system, problem programs and/or opera- 
tors, while the other (the alternate data 
set) is being written to an output device. 

The log is initialized by the routines 
IEEVLIN (see Diagram 17), which locates the 
log data sets and establishes the Log Con- 
trol Area and log buffers, and IEELOG02, 
which writes the log JFCBs to the job 
queue, creates log DCBs, attaches the Log 
Writer routine (IEELWAIT) , and posts the 
log ECB. If the log data sets are not 
located by IEEVLIN, the operator is noti- 
fied that the log option is not supported. 
Consequently, WTL macro instructions are 
reissued as WTO macro instructions to the 
primary/master console. LOG and WRITELOG 
operator commands are treated as NOPs by 
the control program and a message is sent 
to the issuing console informing the opera- 
tor that the system log is not supported. 
IEEVLIN returns control to the Master Sche- 
duler Initialization routine, IEFSD569. 

Users communicate with the log through 
the WTL macro instruction and the operator 
commands LOG and WRITELOG. The WTL rou- 
tines (SVC 36) schedule the entering of 
information into the system log. The LOG 
command is used to enter information into 
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Figure 17. System and Console Output Queues 
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the system log from an operator's console. 
The WRITELOG command is used to request 
that the currently recording log data set 
be closed and queued to a SYSODT writer of 
a particular class. If no class name is 
specified with the WRITELOG command, the 
data set will be scheduled for queueing to 
a SYSOUT writer of the class specified at 
system generation. When the system log is 
performing the functions of the hard copy 
log (a log function of the multiple console 
support option) , WTO and WTOR messages, as 
well as operator and system commands and 
their responses, may be entered on the sys- 
tem log by converting them to a WTL macro 
instruction. WTO and WTOR conversion is 
done in the MCS communications task module 
IEECMDSV. Conversion of the LOG command is 
done in the Command Scheduler (SVC 34) 
routines. 

The log support routines function under 
their own TCB in a manner similar to the 
Communications Task routines. The module 
IEELWAIT is attached as part of the ini- 
tialization process and issues a WAIT macro 
instruction specifying the log ECB. Upon 
initial entry to IEELWAIT, SVC 36 is issued 
to open the log data sets. 

Subsequent entries to IEELWAIT are caused 
when the log ECB is posted. The events 
which cause the log ECB to be posted are: 

• A WRITELOG (CLOSE) command has been 
issued or HALT processing has occurred. 

• The log buffer is full. 

If IEELWAIT is entered because a WRITE- 
LOG command was issued, an SVC 36 is issued 
to cause data set switching. The recording 
data set (primary) is closed and the other 
data set (alternate) is opened for input. 

If IEELWAIT determines that the log buff- 
er is full, it ensures that the size of the 
log buffer to be written does not exceed 
the amount of space specified in the Data 
Extent Block (DEB) . If the log buffer is 
equal to or less than the space remaining 
on the data set, the buffer ECB is posted, 
the log buffer is written to the data set, 
and a WAIT is again issued on the log ECB. 
Had the space remaining on the data set 
been insufficient, an SVC 36 would have 
been issued to simulate a WRITELOG command. 

When a WRITELOG (CLOSE) command is 
entered, the process of writing the remain- 
ing text in the log buffer to the data set 
is the same as mentioned above for a full 
buffer condition. Then the currently re- 
cording data set is closed and the log 
function is deleted from the system. 



An SVC 34 must be issued to process the 
LOG and WRITELOG commands. The SVC 34 
module IEE1603D issues a WTL macro instruc- 
tion. For the WRITELOG command, IEE1603D 
posts the log ECB and the WRITELOG indica- 
tor is set in the Log Control Area. 



The WTL macro instruction results in an 
SVC 36. The module IEE0303F moves the mes- 
sage into the log buffer. If an additional 
message would overflow the buffer, the log 
ECB is posted, the buffer ECB is cleared, 
and control returns to the Master Schedul- 
er. When IEELWAIT receives control, it 
switches buffer pointers, thereby indicat- 
ing that the other (alternate) buffer is 
available for input. It then posts the 
buffer ECB, and proceeds to write the full 
buffer (primary) onto the data set. Since 
the buffer ECB has been posted, IEE0303F 
can now move a new message into the altern- 
ate buffer. When IEE0303F is entered from 
IEELWAIT because a WRITELOG was issued (SVC 
36 is issued in IEELWAIT) , control is 
passed directly to the second load of SVC 
36 IEE0403F. 

When IEE0403F is entered initially, the 
log data sets are opened and control blocks 
initialized. Upon subsequent entry, the 
currently recording data set (primary) is 
closed and scheduled for queueing to the 
SYSOUT writer. The other data set becomes 
the primary data set and pointers are 
adjusted accordingly. Messages are written 
to the operator indicating the switch of 
data sets, or the failure of a data set to 
be opened. When an alternate data set is 
not available (usually because the data set 
is still being written by the system output 
writer) , the system log is temporarily made 
inactive. During the time that the log 
function is inactive, the buffer remains 
undisturbed and all incoming WTL macro 
instructions are reissued as WTO macro 
instructions to the primary /master console. 

Anytime the operating system enters step 
termination and a log data set has been 
scheduled for queueing, the termination 
module IEFSD42Q passes control to the Log 
Dispatcher IEEVLDSP. IEEVLDSP enqueues the 
log data set to a system output queue of a 
particular class and issues a corresponding 
message to the operator. 

After the log data set has been written, 
control is returned to the routine IEEV- 
IOUT, which opens and immediately closes 
the data set to reinitialize the TTRLL 
field (a field that describes the space 
available on the data set) . IEEVLOUT 
returns control to the SYSOUT Writer rou- 
tine that called it. 
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TIMER SUPERVISION 



The Timer Supervision routines extend 
the capabilities of the IBM System/360 
interval timer feature and the System/370 
Time-of-Day (TOD) Clock. Using the timer 
supervision routines, the programmer can 
obtain the date and time of day, measure 
periods of time between specified points in 
execution, or schedule activity for a spe- 
cific time of day. The timer supervision 
routines also service the job- step timing 
and system management facility features. 

This chapter contains a general descrip- 
tion of timer supervision as follows: 

"Timer Supervision Services" describes 
the services available to the problem 
programmer. 

o "The Functions of Timer Supervision" 
describes the operation of the supervi- 
sor in performing the services 
requested by the user. 

o "Timer Supervision with the Time-of-Day 
(TOD) Clock." 

Diagram 18 illustrates the control flow 
of timer supervision when invoked through 
the supervisor call interruption handlers. 



• The STIMER (Set Timer) routine pro- 
cesses requests for timed intervals by 
scheduling their placement into the 
interval timer to cause interruptions 
at requested times. For each STIMER 
macro instruction, this routine builds 
a Timer Queue Element (TQE) and places 
into it the information from the STIMER 
macro instruction that will be needed 
when the interval expires. It then 
positions the element in the timer 
queue using its time of expiration to 
determine its position. When a timer 
interruption occurs (the value in the 
timer has decremented to -1), timer 
interruption handling routines perform 
the requested actions and obtain a new 
interval to be placed into the timer 
from the next element in the timer 
queue. 

o The TTIMER (Test Timer) routine returns 
the time remaining in a previously 
requested interval, or cancels previous 
STIMER requests. To determine remain- 
ing time, the TTIMER routine subtracts 
elapsed time from the time of expira- 
tion of the interval. To cancel pre- 
vious requests, the TTIMER routine 
removes corresponding elements from the 
timer queue. 



SYSTEM/360 TIMER SUPERVISION SERVICES 

The timing services available depend on 
the options selected when the operating 
system is generated. These options are the 
time option , which provides the ability to 
request the date and time of day, and the 
interval option , which includes the time 
option functions and also provides the 
ability to set, test, and cancel intervals 
of time. If neither option is selected, 
then the date is the only timing service 
provided. 



SYSTEM/370 TIMER SUPERVISION SERVICES 

Control programs executing on System/ 370 
CPUs use the interval timer feature and the 
Time-of-Day (TOD) Clock, a standard feature 
on these CPUs which provides timing resolu- 
tion to one microsecond. In the following 
description of timer supervision, dif- 
ferences with the System/370 Time-of-Day 
Clock, if any, are discussed immediately 
after the descriptions of each timer rou- 
tine or function. 



The following routines provide the timer 
services: 

o The TIME routine returns the current 
date and time of day. The operator 
initially gives a starting date and 
time of day with a SET command. 
Thereafter, Timer Supervision changes 
the date each midnight and maintains 
elapsed time. The TIME routine obtains 
the current date, adds elapsed time to 
the starting time given by the opera- 
tor, and returns both values in general 
registers. 



The operator need reset the clock only 
when the current date and time of day are 
incorrect, not at each IPL. The TOD Clock 
runs continuously while power is on. 

Because the TOD Clock maintains elapsed 
time automatically (using 0000 hours, 
January 1, 1960, as the base), the TIME 
routine uses the TOD Clock to update, if 
necessary, the current date and to deter- 
mine the time of day. The current date and 
time of day are returned to the caller in 
the manner specified in the TIME macro 
instruction. 
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When the requested interval is greater 
than one hour, the STIMER routine uses the 
TOD Clock to determine the value expected 
to be in the TOD Clock at expiration. When 
the requested interval is less than or 
equal to one hour, the System/360 process- 
ing is used. 

To determine the time remaining in an 
interval, the TTIMER routine subtracts the 
value in the TOD Clock from the value 
expected to be in the TOD Clock at 
expiration. 



FUNCTIONS OF TIMER SUPERVISION 

The functions of timer supervision are 
related to measuring elapsed time intervals 
and servicing a request upon expiration of 
a timer interval. Functions related to 
measuring elapsed time intervals include: 

o Measuring elapsed time. 

• Maintaining the timer queue. 

• Measuring time of expiration. 

• Determining interval values, 

• Timer interruption handling. 

Functions related to servicing requests 
upon expiration of a timer interval 
include: 

• Determining what actions are to be 
performed . 



• Altering timer requests. 



MEASURING ELAPSED TIME IN SYSTEM/360 

The TIME routine determines the current 
date and time of day and returns both 
values to the requesting routine. It 
obtains the date from the Communication 
Vector Table, into which it was placed by 
the Job Management SET Command routine. 
(Each day at midnight, the date is changed 
by the Timer Second-Level Interruption 
Handler.) To determine the time of day, 
however, the TIME routine must first deter- 
mine how much time has elapsed since the 
operator gave the SET command. 

The console operator issues the SET com- 
mand to place the current time into a soft- 
ware clock called the local time pseudo- 
clock (LTPC) . Unless the operator places 
the correct value into the LTPC, the timer 
routines will not calculate the correct 
time corresponding to the actual time of 
day. The LTPC should be initialized to the 
correct time during each initial program 
load (IPL) performed on the system. 



After the operator gives a starting 
time, the interval timer must be kept con- 
tinually operating so that elapsed time can 
be measured. The interval timer automatic- 
ally decrements any value placed into it 
and causes an interruption when the value 
becomes negative. During initial program 
loading (IPL) , a 6-hour value is placed 
into the interval timer, and, when this 
value expires, another 6 -hour interval is 
placed into the timer by the Timer Second- 
Level Interruption Handler. 

To measure elapsed time, three pseudo 
clocks are used with the interval timer: 
the local time, the 6-hour, and the 24-hour 
pseudo-clock. Each time a 6-hour value is 
placed into the timer, one is also placed 
into the 6-hour pseudo clock. However, the 
value in the timer decrements, while that 
in the 6-hour pseudo clock does not. Thus, 
an elapsed time of up to 6 hours can be 
determined by subtracting the value in the 
timer from that in the 6-hour pseudo clock. 

To measure intervals longer than 6 
hours, a 6-hour value is added into the 
24-hour pseudo clock each time one is 
placed into the 6-hour pseudo clock except 
for the first 6- hour interval. (Each time 
a 24-hour period elapses, the 24-hour pseu- 
do clock is reset to 0.) The TIME routine 
determines elapsed time by subtracting the 
value in the timer from the sum of the 
values in the 6-hour pseudo clock (SHPC) 
and the 24-hour pseudo clock (T4PC) : 

Elapsed Time = (SHPC + T4PC) - Timer 

Elapsed time is added to the starting time 
stored by the operator in the LTPC to 
arrive at the current time of day (TOD) . 

TOD = Elapsed Time + LTPC 

For example, Figure 18 illustrates the 
timer, SHPC, T4PC, and LTPC immediately 
following initial program load. Figure 19 
contains timer and pseudo-clock values at 
some later time. To calculate elapsed 
time, the formula is applied: 

Elapsed Time =(6+ 6) -3=9 hours 
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Figure 18. Timer Clocks after IPL 
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Figure 19. Measuring Elapsed Time 
Intervals 



MEASURING ELAPSED TIME IN SYSTEM/370 

With the TOD Clock, an additional param- 
eter (MIC, address) is used to obtain the 
time of day in microseconds. The date is 
obtained from the CVT, as in System/360 
processing, but all calculations to deter- 
mine the time of day are performed in 
microseconds. 

Each time that the TIME routine 
(IEA0RT01) is entered, the current date is 
verified using the value in the TOD Clock. 
The MNIGHT field in the nonexecutable timer 
module IEACVTPC contains the value that is 
expected to be in the TOD Clock at midnight 
of that day. From the MNIGHT value „ the 
TIME routine subtracts the current value in 
the TOD Clock. If the result is positive, 
midnight of that day has not been reached 
and the current date is correct. If the 
result is or negative, midnight of that 
day has been passed. The current date in 
the CVT is incremented by one day, the 
MNIGHT value is incremented by 24 hours (in 
microseconds) , and the synchronization 
indicator in the midnight element is set 
on. Because the variance in the current 
date may have been more than one day, the 
procedure described above is repeated until 
the result of the subtraction is positive. 

The TIME routine does not calculate the 
time of day in a manner similar to the TIME 
routine in System/360. Instead, the TIME 
routine uses the TOD Clock and the follow- 
ing algorithm to calculate the time of day 
in microseconds: 

TOD = 86.4 X 10 9 - (MNIGHT - CLOCK) 

where: 

86.4 x 10 9 

is the number of microseconds in one 
day. 

MNIGHT 

is the value expected to be in the TOD 
Clock at midnight of the current day. 



CLOCK 

is the current value of the TOD Clock. 

(MNIGHT - CLOCK) 

yields the number of microseconds 
remaining until midnight of the cur- 
rent day. 

For a time of day request specifying the 
MIC operand, the user-specified address is 
checked for validity. If the address is 
invalid, register is set to 0, register 1 
contains the date, the specified location 
is unchanged and control is returned to the 
caller with a code of 4 in register 15. 
For a valid address, register 15 is set to 

0, the current date is returned in register 

1, and the time of day is returned in the 
doubleword field specified by the caller; 
register is set to 0. 

If the TU operand was specified, the 
calculated time is converted to timer units 
by dividing the microsecond value by 
26.041666. If the BIN or DEC operands were 
specified, the calculated time is divided 
by 10000 and the result is returned if BIN. 
If DEC was specified, the result is con- 
verted to HHMMSSth format. 



Note: 



If the TIME routine is entered 



before nucleus initialization is complete, 
the date is returned as X^OOOOOOOF' and the 
time is returned as 0. 



Timer Units and Values 

The values used in the timer are timer 
units equalling approximately 13 microse- 
conds; the values used in the pseudo clocks 
are timer units equalling 26.04166 microse- 
conds. Timer values are converted to units 
of 26.04166 microseconds for calculations. 
The TIME routine converts the time of day 
to packed decimal form if the decimal (DEC) 
option was specified in the TIME macro 
instruction or to an unsigned binary value 
if the binary (BIN) option was specified. 
If the timer units (TU) option was given, 
no conversion is performed. The current 
time of day is returned to requesters in 
general register 0, and the date is 
returned in general register 1. 



Timer Queue Elements 

Timer Queue Elements (TQEs) are used by 
the system in supervising use of the hard- 
ware timer. Each task in a system with the 
interval timer option has a 96-byte block 
of main storage adjacent to the task con- 
trol block for use as a timer queue ele- 
ment. A TQE is considered "not in use" 
until it is queued to a timer queue. A TQE 
that is not in use, however, can be used as 
an interruption request block (IRB) to 
execute a timer asynchronous exit routine. 
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MAINTAINING THE TIMER QUEUE 

The timer queue is a chain of active 
TQEs that represent requests for timing 
services- The communications vector table 
(CVT) contains a pointer to module 
IEACVTPC. This module contains the pseudo 
clocks; the 6-hour , 24-hour r the optional 
SMF TQE, and the dummy TQEs; and the point- 
er to the timer queue (TQPTR) • Figure 20 
illustrates module IEACVTPC following nuc- 
leus initialization. 



All elements in the timer queue are 
arranged by time of expriation. After a 
timer interruption, the topmost element 
always represents the expired interval. 
This element is removed from the queue and 
used to determine what action is to be 
taken. Meanwhile, the interval represented 
by the next element (if it has not expired) 
is placed into the interval timer, and the 
procedure begins again. 



MEASURING TIME OF EXPIRATION IN SYSTEM/360 
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The time of expiration, by which ele- 
ments are ordered on the timer queue, is 
based on a 6- hour cycle. The STIMER rou- 
tine places the interval requested in the 
element and uses the timer enqueue routine 
in the Timer SLIH to convert the interval 
to a time of expiration and to place the 
element on the timer queue. The timer 
enqueue routine subtracts the value in the 
interval timer from the value in the 6-hour 
pseudo clock (SHPC) and adds the interval 
requested: 

TOX = (SHPC - Timer) + interval requested 

For example, assume that no requests are 
pending and that 3 hours have elapsed since 
the operator issued a SET command. Figure 
21 shows the timer queue and the values in 
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Figure 20. The Nonexecutable Timer Module 
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both the timer and the 6 -hour pseudo clock 
at this time. Assume now that a STIMER 
macro instruction requests a timer inter- 
ruption in 5 hours. The time of expiration 
(T0X) is determined: 

TOX = (SHPC - Timer) + interval requested 
8 = ( 6 - 3 ) + 5 

The element representing the 5-hour re- 
quest is positioned on the timer queue 
between the 6-hour and midnight elements. 
Both the 6-hour and midnight elements 
always exist on the queue. When the 6-hour 
element expires, the Timer Second- Level 
Interruption Handler subtracts 6 hours from 
the times of expiration of all other ele- 
ments on the timer queue and repositions 
the 6-hour element. Thus the element 
representing the request then becomes the 
topmost element , and its 2-hour time of 
expiration is placed into the interval 
timer. A timer interruption will occur on 
schedule — 5 hours after receipt of the 
request. When the midnight element 
expires , the Timer Second-Level Interrup- 
tion Handler changes the date given by the 
operator and repositions the midnight 
element. 



DETERMINING INTERVAL VALUES IN SYSTEM/360 

The STIMER macro instruction allows the 
user to specify the time interval in one of 
four ways: decimal form (DINTVL) , binary 
form (BINTVL), timer units (TUINTVL) , and 
time of expiration (TOD) . when decimal or 
binary form is given, the STIMER routine 
converts the value to timer units (one 
timer unit = 26.041666 microseconds) , 
before using the timer enqueue routine. 
When timer units are given, no conversion 
is necessary. 



When time of expiration (TOD) is speci- 
fied in the STIMER macro instruction, STIM- 
ER converts the time to an interval by sub- 
tracting the current time of day from the 
specified time of expiration. The interval 
is converted to timer units before using 
the timer enqueue routine. The current 
time of day is determined using the follow- 
ing algorithm: 

Current Time of Day = LTPC + T4PC + 
(SHPC - Timer) 

where: 



LTPC 



MEASURING TIME OF EXPIRATION IN SYSTEM/370 

The timer queue in System/370 is similar 
to that in System/360. However, the STIMER 
routine uses the TOD Clock to process REAL 
and WAIT type requests when the interval 
specified is greater than one hour. (REAL 
and WAIT type requests for intervals less 
than or equal to one hour and TASK type 
requests are processed as in System/360.) 
STIMER converts the requested interval from 
timer units to 1.048576-second units and 
adds the resulting value to the current 
value in the TOD Clock. (Bit 31 in the TOD 
Clock is incremented every 1.048576 
seconds. Microsecond values are indicated 
by bit 51.) This yields the expected value 
of the TOD Clock at the time of expiration 
of the specified interval. This value is 
saved in the TQEWORK field in the element 
and will be used by the timer SLIH each 
time that the one-hour interval for this 
element expires. (See "Determining What 
Actions are to be Performed in System/370" 
below. ) STIMER places an interval of one 
hour (in timer units) in the field TQEVAL 
in the element, sets on the synchronization 
indicator in the element, and uses the 
timer enqueue routine in the timer SLIH to 
convert the interval from timer units to a 
time of expiration and to place the element 
on the timer queue. Although the interval 
specified was greater than one hour, a 
timer interruption will occur in one hour 
and the element will be examined by the 
timer SLJH for further processing. (See 
"Timer Interruption Handling" below.) 



starting time given by the operator in 
the SET command. 



T4PC 



value in the 2 4 -hour pseudo clock. 



SHPC 



value in the 6- hour pseudo clock. 



Timer 

value in the timer. 

Because no interval that exceeds 24 hours 
is valid, the STIMER routine replaces any 
interval that exceeds 24 hours with a 24- 
hour interval. 



DETERMINING INTERVAL VALUES IN SYSTEM/370 

The DINTVL, BINTVL, and TUINTVL operands 
are processed in a manner identical with 
System/360. When a time of expiration 
(TOD) is specified as the operand in a 
STIMER macro instruction, the STIMER rou- 
tine uses the TOD Clock to determine the 
interval. STIMER first converts the time 
of expiration to a value in timer units 
that represents the interval between the 
beginning of that day (0000 hours) and the 
specified time of expiration. From this 
value, STIMER then subtracts the current 
time of day in timer units. The current 
time of day in timer units is calculated 
using the following algorithm: 
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TCD = (82397 - tMNIGHT - CLOCK]) x 40265 

where : 

MNIGHT 

is the value expected to be in the TOD 
Clock at midnight of that day. 

CLOCK 

is the current value of the TOD Clock. 

If the specified time of expiration has 
already been passed (the interval value is 
negative) , STIMER adds the number of timer 
units in one day to the interval so that 
the time of expiration will occur at the 
specified time on the next day. 

Initializing the Timer Queue Element 

The STIMER routine initializes queue 
elements using information provided by the 
programmer in the STIMER macro instruction. 
It first checks to determine if the exist- 
ing element can be used. This element 
could be an expired element r an element in 
the timer queue , or one that was changed to 
an interruption request block by the Timer 
Second-Level Interruption Handler. The 
STIMER routine reuses expired elements and 
removes and reuses elements that are on the 
timer queue. If the existing element has 
been changed to an interruption request 
block that is being used/ the STIMER macro 
instruction is treated as a NOP, and con- 
trol returns to the caller. The STIMER 
routine then uses the Timer ENQ subroutine 
to position the completed element on the 
timer queue. 



TIMER INTERRUPTION HANDLING 

When a time interval in the timer 
expires, an external interruption occurs, 
and control is automatically given to the 
Timer/External First-Level Interruption 
Handler (see Diagram 19) . The Timer/ 
External First Level Interruption Handler 
saves information about the interrupted 
program, distinguishes between timer and 
other types of external interruptions, and, 
for timer-caused interruptions, gives con- 
trol to the Timer Second- Level Interruption 
Handler. 

The Timer Second-Level Interruption 
Handler takes any actions the programmer 
specified (in the STIMER macro instruction) 
to be performed upon expiration and places 
another interval into the timer. 



DETERMINING WHAT ACTIONS ARE TO BE 
PERFORMED IN SYSTEM/ 360 

When a timer interruption occurs, the 
topmost element in the timer queue repre- 



sents the expired interval. The Timer 
Second-Level Interruption Handler obtains 
the address of the topmost element from 
main storage location TQPTR, removes the 
element from the timer queue, and deter- 
mines what action to take using bits 4 
through 7 of the first word in the element. 



If a TASK or REAL parameter was given in 
the STIMER macro instruction, and if an 
asynchronous exit routine was specified in 
the STIMER macro instruction, the Timer 
Second-Level Interruption Handler (TSLIH) 
roust make further tests to determine what 
action should be taken. If no entry to an 
asynchronous exit routine is desired, the 
queue element is given an expired status. 
If an exit is specified and the timer queue 
element (TQE) is TASK type, the TSLIH 
changes the TQE to an interruption request 
block (IRB) containing an interruption 
queue element (IQE) , and gives control to 
the Stage 2 Exit Effector. 



If the TQE is REAL, if an exit is speci- 
fied, and if an initiator issued the STIMER 
macro instruction, it indicates that the 
30-minute wait limit (imposed by job step 
timing) has expired. When this case 
occurs, the problem program must be abnorm- 
ally terminated while the timer queue ele- 
ment must be reinstated as TASK type with 
the actual CPU time remaining value. The 
Timer Second- Level Interruption Handler 
accomplishes this by branching to ABTERM 
with the address of the problem program job 
step TCB to schedule the step for ABEND. 
The TSLIH also passes ABTERM a unique ABEND 
code (522) which indicates that the 30- 
minute wait limit expired. Upon return 
from ABTERM, the TSLIH marks the timer 
queue element as TASK type and off the 
queue, and moves the CPU time remaining 
value from its save slot (TQESAV) to the 
time of expiration/time remaining slot 
(TQEVAL) within the TQE. 



If a WAIT parameter was given in the 
STIMER macro instruction, the Timer Second- 
Level Interruption Handler gives control to 
the POST routine, directing it to post an 
appropriate event control block (contained 
within the timer queue element) and thus 
signal expiration of the interval. 



After either of the above actions have 
been completed, the time of expiration 
(TCX) value of the topmost element is 
placed in the 6-hour pseudo clock. The TOX 
value minus the last value in the 6-hour 
pseudo clock is placed in the interval 
timer. (The element representing the 
recently expired interval has been removed 
from the queue.) 
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DETERMINING WHAT ACTIONS ARE TO BE 
PERFORMED IN SYSTEM/370 

When the element at the top of the timer 
queue is removed by the timer SLIH, the 
synchronization indicator is checked to 
determine if this element is the 24-hour 
element or represents a REAL or WAIT type 
request that requires special processing by 
the timer SLIH. This indicator will have 
been set by the STIMER routine when the 
original interval requested was greater 
than one hour. Interim processing by the 
timer SLIH may have cleared this indicator. 



If special processing is not required, 
System/360 processing continues. If the 
indicator is set, the timer SLIH subtracts 
the value in the TOD Clock from the value 
in the TQEWORK field. If the result is 
or negative, the interval being timed has 
elapsed and processing continues as in 
System/360. If the result is positive but 
less than one hour, the synchronization 
indicator is cleared, and the remaining 
interval is converted from 1.048576-second 
units to timer units and placed in the 
TQEVAL field. The timer enqueue routine is 
used to convert the timer units to time of 
expiration and to place the element on the 
timer queue. 



If the result of the calculation is 
positive and greater than one hour, the 
timer SLIH again sets the TQEVAL field to 
one hour, and uses the timer enqueue rou- 
tine to convert the timer units to a time 
of expiration and to place the element on 
the timer queue. 

Returning 6-Hour and Midnight Elements to 
the Queue in System/360 

When intervals represented by either the 
6-hour or midnight elements expire, the 
elements must be returned to the timer 
queue. Before it returns the 6-hour super- 
visor element, the Timer Second- Level 
Interruption Handler subtracts 6 -hours from 
the times of expiration of all elements in 
the timer queue to reflect the passing of 6 
hours since the elements were queued. It 
also adds 6 hours to the 2 4- hour pseudo 
clock unless its value is 18 hours, in 
which case it resets the 2 4- hour pseudo 
clock to 0. The Timer Second-Level Inter- 
ruption Handler then uses the Timer ENQ 
subroutine to position and queue the 6-hour 
element on the timer queue. 



Before the Timer Second-Level Interrup- 
tion Handler returns the midnight element 
to the timer queue, it changes the date in 
the communications vector table. 



Returning 6-Hour and Midnight Elements to 
the Queue in System/370 

This processing is identical with 
System/360 except that the 24-hour pseudo 
clock is not used in System/370. This is 
replaced by the MNIGHT field in module 
IEACVTPC which is used with the TOD Clock. 



ALTERING TIMER REQUESTS 

The TTIMER routine returns the time 
remaining in a previously requested time 
interval or cancels a previously requested 
interval. 

Determining Remaining Time in System/360 

Before the TTIMER routine can determine 
remaining time, it must first locate the 
queue element that represents the affected 
interval. It obtains the address of the 
element from the TCB of the task being per- 
formed when the TTIMER macro instruction 
was given. If no element exists, or if the 
interval represented by the element has 
expired, this routine returns a 0. If an 
unexpired interval exists, the TTIMER rou- 
tine determines remaining time by using the 
following formula: 

Remaining Time = TOX - (SHPC - Timer) 

where: 



TOX 



time of expiration of the element. 



SHPC 



value in the 6-hour pseudo clock. 



Timer 

value in the interval timer. 

The interval may have expired while the 
TTIMER routine was being executed, in which 
case the above calculation would yield a 
negative remaining time value. If so, a 
value is returned in general register 0. 
If a positive remaining time value is 
obtained, it is placed unaltered (in timer 
units) into general register . 

Determining Remaining Time in System/370 

When a TTIMER request specifies an ele- 
ment that has the synchronization indicator 
set, the TTIMER routine determines the 
remaining time by subtracting the value in 
the TOD Clock from the value in the TQEWORK 
field in the element. A or negative 
value indicates that the interval has 
elapsed and TTIMER returns a in register 
0. A positive value is converted to timer 
units and returned to the requester in 
register 0. 
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Canceling an Interval 

If the CANCEL option was used in the 
TTIMER macro instruction, the TTIMER rou- 
tine uses the Timer Dequeue subroutine to 
remove the corresponding element from the 
timer queue. The TTIMER routine also 
clears the TQE pointer (TCBTME) in the cur- 
rent TCB. The current task thus no longer 
has a timer queue element. 



SMF PROCESSING AND JOB STEP TIMING 

When the System Management Facility 
(SMF) has been included in the system, the 
Timer SLIH may perform additional 
processing. 

If the timer interruption is recognized 
as following the expiration of a supervisor 
10 -minute TQE, the Timer SLIH obtains the 
accumulated system wait time for the 10 
minutes from the second word of the save 
area SYSWSAVE. This value is added to the 



SMCAWAIT + 4 field in the system management 
control area. (Refer to "Special Features" 
for a description of the SMF option.) Each 
time that step termination is entered, this 
field is checked. If it is not zero, a 
system 10-minute wait record is generated. 



The Timer SLIH then sets the accumulated 
wait time field to zero, places a value of 
10 minutes in the 10-minute TQE, and 
returns the TQE to the timer queue. 

If the timer interruption is recognized 
as a job, step, or wait time expiration, 
the Timer SLIH checks the timing control 
table (TCT) for the address of a user time 
limit expiration routine (IEFUTL) . If such 
a routine is present, and if the expired 
TQE belongs to the initiator, the Timer 
SLIH initializes an IRB/IQE representing 
the SMF Time Limit Expiration routine 
(IEATLEXT). The Stage 2 Exit Effector is 
then entered to schedule the execution of 
the SMF Time Limit Expiration routine. 
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OVERLAY SUPERVISION SERVICES 



Overlay supervision controls the loading 
of overlay program segments and assists the 
flow of control between the segments of an 
overlay program. While performing these 
functions , overlay supervision places data 
into, and uses data from, the segment table 
(SEGTAB) and the entry tables (ENTABs) . 

Because the segment and entry tables are 
part of each overlay program, the overlay 
supervisor is reenterable; its services can 
be used concurrently by many overlay 
programs . 

During execution, an overlay program 
issues requests for segments. The requests 
can be explicit via a SEGLD or SEGWT macro 
instruction, or implicit via a branch that 
is routed through an ENTAB. In either 
case, the overlay supervisor receives con- 
trol from the SVC handler and checks the 
SEGTAB to determine whether the requested 
segment is in main storage. If not, the 
overlay supervisor requests Program Fetch 
to load the segment. When this segment is 
part of an overlay program that is being 
tested, the overlay supervisor also passes 
control to the TESTRAN interpreter. Pro- 
gram Fetch and the TESTRAN interpreter each 
return control to the overlay supervisor 
after their functions have been performed. 



OVERLAY SUPERVISION ROUTINES 

Overlay supervision is composed of a 
resident module (IEWSVOVR) called overlay 
supervisor 1, and either of two nonresident 
modules selected during system generation 
called overlay supervisor 2. The module 
name of overlay supervisor 2 is IEWSYOVR 
for the basic sychronous module, or 
IEWSXOVR for the basic synchronous module 
with optional SEGWT checking. To pass con- 
trol to either version of overlay supervi- 
sor 2, overlay supervisor 1 issues a LINK 
macro instruction that specifies IEWSZOVR, 
which is the member name of the selected 
module in the LINKLIB. 



FUNCTIONS OF OVERLAY SUPERVISION 

Overlay supervision in this manual 
includes the functions of and operations 
performed by the overlay supervisor, the 
linkage editor, contents supervision, and 
Program Fetch. The functions of overlay 
supervision include the following: 



• Building and Initializing Control 
Areas. 

• Servicing Requests for Linkage to Over- 
lay Program Segments. 

• Passing Control to the Requested 
Segment. 



TABLES USED BY OVERLAY SUPERVISION 

The segment table (SEGTAB) and the entry 
tables (ENTABs) that contain the data used 
by the overlay supervisor are created by 
the linkage editor from information in the 
relocation dictionary (RLD) and the user's 
control statements. Figure 22 shows the 
SEGTAB and ENTABs in a typical single 
region overlay structure; the ENTAB and 
SEGTAB formats are given in Section 5. 



Ill 



Text 



Mil 



Text 



ENTAB 



SEGTAB 



Text 



ENTAB 



Root Segment 
(Seg 1) 



Mlllllllllllllll 



SEG 2 



SEG 5 



llllllllllll 



SEG 3 



II 



Text 



SEG 4 



MM 



Text 



Figure 22. Single Region Overlay Structure 
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Segment Table 

The segment table (SEGTAB) contains data 
that describes the structure and status of 
an overlay module, and is a directory for 
the segments of that module. It contains 
both fixed and variable information. The 
fixed information includes: 

• TEST indicator . This indicator is set 
by Program Fetch if the partitioned 
organization directory record indicates 
that the program is being tested under 
TESTRAN. 

• Last segment number of each region . 
This value defines the segment that 
ends a region and is used to determine 
the region that contains a particular 
segment. 

• Previous segment number of each segment 
in the module . The overlay supervisor 
uses this field to determine the addi- 
tional segments that must be loaded 
with the requested segment. (These 
additional segments are those in the 
path of the requested segment.) 

The variable information includes: 

• Pointers . These pointers are addresses 
of the NOTE list and DCB. 

• Highest number segment of each region 
in main storage . This value is ini- 
tialized to 1 for the first region by 
the linkage editor. 

• Status indicator for each segment . The 
overlay supervisor sets a status indi- 
cator for each segment to indicate 
either that the segment is not in main 
storage, that the segment is being 
loaded into main storage, or that the 
segment is present in main storage. 

Entry Tables 

The entry tables (ENTABs) assist in 
passing control between the overlay super- 
visor and an overlay program. They handle 
downward branches in an overlay program, 
that is, the branches to segments lower in 
the path. 

When the overlay program executes an 
upward branch, the overlay supervisor is 
not entered, and the ENTABs and SEGTAB are 
not used. An upward branch is direct 
because segments in the path are always in 
main storage (Figure 23) . 



BUILDING AND INITIALIZING CONTROL TABLES 

Before execution of an overlay object 
module, the Linkage Editor builds, from 
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Figure 23. Overlay Program Upward Branch 



information in the relocation list dic- 
tionary (RLD) and the user's Linkage Editor 
control statements, a segment table and one 
or more entry tables. These tables are 
made a part of the overlay load module and 
are used by the overlay supervisor during 
module execution. 

The input to the Linkage Editor is an 
object module including Linkage Editor con- 
trol statements. The OVERLAY control 
statement indicates the beginning of an 
overlay segment. It may also indicate the 
beginning of an overlay region. 

An overlay module can be designed in 
single or multiple regions (as many as 
four). A region is a contiguous area of 
main storage within which segments can be 
loaded independently of paths in other 
regions. 

When the Linkage Editor processes an 
overlay object module, it builds a segment 
table (SEGTAB) as part of the root segment 
and an entry table (ENTAB) for each segment 
except the lowest segment in a path. The 
segment table contains one entry for each 
segment of the overlay module. The entries 
in the segment table are ordered to corres- 
pond to the segment numbers of the overlay 
structure. Each entry contains the number 
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of the preceding segment in the path and a 
field of status indicators. The segment 
table entries form a tabular representation 
of the overlay structure. 

The SEGTAB records the relationship of 
the segments in the overlay module and 
specifies which segments are loaded into 
main storage at a given time, A segment's 
ENTAB contains an entry for each V-type 
address constant that refers to a symbol in 
a different segment of the overlay module. 



SERVICING REQUESTS FOR LINKAGE TO OVERLAY 
PROGRAM SEGMENTS 

The overlay supervisor receives control 
either when an overlay segment issues a 
SEGLD or SEGWT request to load another seg- 
ment, or when a segment issues a CALL or 
branch instruction to an external address 
in another segment not in main storage. 
When the overlay supervisor receives con- 
trol because of a SEGLD request , it returns 
immediately to the interrupted program. 
When the overlay supervisor receives con- 
trol for any other reason, it examines the 
segment table to determine whether the 
requested segment is already in main 
storage, and whether all segments in its 
path have been loaded. If it is not al- 
ready in main storage, it causes the 
requested segment (and any needed segments 
in its path) to be loaded by Program Fetch. 

When loading is complete and the caller 
has issued a CALL or branch instruction, 
the overlay supervisor alters the entry 
tables of the loaded segments. The modi- 
fied entry tables permit future branches to 
the same points in the loaded segments 
without help from the overlay supervisor. 

Finally, depending on the type of invok- 
ing macro instruction, control is given to 
the caller, after loading is complete 
(SEGWT) , or to the branch address in the 
requested segment, after the segment is 
loaded (CALL or branch instruction) • 

Linkage to the Overlay Supervisor 

Linkage to the overlay supervisor is 
initiated directly for a SEGLD or a SEGWT 
macro instruction. It is initiated 
indirectly for a CALL or branch 
instruction. 

Direct Supervisor Linkage : When the SEGLD 
macro instruction expands, a is placed in 
register and an SVC 37 instruction is 
issued. When the SEGWT macro instruction 
expands, a 1 is placed in register and an 
SVC 37 instruction is issued. Execution of 
the SVC instruction causes an SVC interrup- 
tion, and control passes to the SVC FLIH, 



SVC SLIH, and resident module IEWSVOVR of 
the Overlay Supervisor (at entry point 
IGC037). If the interruption was caused by 
a SEGLD request (0 in register 0), the 
Overlay Supervisor returns immediately to 
the routine that issued SEGLD. SEGLD is 
treated as a NOP (no operation) in MFT. If 
the interruption was caused by a SEGWT 
request (1 in register 0) , then the overlay 
supervisor determines if a direct branch 
entry to the requested segment, via the 
caller's ENTAB, has been prepared through a 
previous branch or CALL. If it has, con- 
trol is returned to the caller (see Diagram 
20) because further processing of the cur- 
rent request is not needed. If a direct 
branch entry has not been prepared, module 
IEWSVOVR, after performing initialization, 
issues a LINK macro instruction to obtain 
supervisor -assisted linkage to nonresident 
module IEWSZOVR. IEWSZOVR is the name on 
the LINKLIB given to either module IEWSYOVR 
or module IEWSXOVR. One of these two 
modules is selected during System Genera- 
tion. IEWSYOVR is the basic synchronous 
transient Overlay Supervisor Module. 
IEWSXOVR is the synchronous Transient Over- 
lay Supervisor Module with optional SEGWT 
checking. Module IEWSZOVR processes the 
request, as described in "Types of 
Processing." 

Indirect Supervisor Linkage : When a branch 
instruction or CALL macro instruction in an 
overlay segment is executed, specifying a 
V-type address constant, a branch is made 
to the associated ENTAB entry, which 
branches to an SVC 45 instruction in the 
last ENTAB entry. When the SVC instruction 
is executed, an SVC interruption occurs, 
and control passes to the SVC FLIH, SVC 
SLIH, and resident module IEWSVOVR of the 
Overlay Supervisor (at entry point IGC045) . 
(See Figure 24, steps A, B, and C.) After 
performing initialization, module IEWSVOVR 
issues a LINK macro instruction to obtain 
supervisor-assisted linkage to nonresident 
module IEWSZOVR. Module IEWSZOVR processes 
the branch request, as described in "Types 
of Processing." 

Types of Processing 

The processing performed by the overlay 
supervisor depends on: 

1. Whether the requested segment and all 
segments in its path are in main 
storage (because of a previous 
request) . 

2. How the overlay supervisor received 
control: a SEGLD request caused an 
SVC 37 interruption; a SEGWT request 
caused an SVC 37 interruption; a CALL 
or branch to an ENTAB caused an SVC 45 
interruption. 
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Figure 24. Branching to a Segment 



A CALL or branch to an ENTAB does not 
cause an SVC (45) interruption if the 
requested segment is in main storage and if 
the caller's ENTAB has already been altered 
to provide a direct branch (by a previously 
serviced SVC (45) interruption). 



trol a subsequent fetch process. During the 
scan of the segment table, the entry for 
the requested segment is located, and its 
status indicators are examined. The resul- 
tant processing is tabulated in Figure 26. 



Overlay supervision processing for each 
of the above sets of conditions is shown in 
Figure 25. 



Determining the Status of a Requested 
Segment (and All Segments in Its Path) 

The nonresident module of the overlay 
supervisor (IEWSZOVR) determines which seg- 
ments in the path of the requested segment 
should be loaded by scanning the status 
indicators in the segment table of the 
overlay module. For each segment that must 
be loaded, IEWSZOVR sets indicators to con- 



Loading the Required Segments into Main 
Storage 

After the SEGTAB has been scanned and 
the entries for the segments to be loaded 
have been marked, these segments are loaded 
into main storage using Program Fetch. If 
the segments are loaded in response to a 
SEGWT request, the overlay supervisor 
returns to the calling routine. If the 
segments are loaded in response to a CALL 
or branch request, the overlay supervisor 
adjusts the ENTAB entries to permit an 
unassisted branch to the newly loaded 
segment (s). 
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Type of 
Instruction 



1 . SEGLD 

(SVC 37) 



4 



2 . SEGWT 

(SVC 37) 



Status of 
Requested Segment (s) 



Irrelevant 



--+■ 



Not in main storage 



Major Overlay 
Supervision Processing 



Control is returned to the caller. 



Needed segments are loaded. The callers entry 
table is not altered to prepare for a branch to 
the requested segment control is returned to the 
caller after the requested segment and any needed 
segments in its path have been loaded. 



3. 



SEGWT 
(SVC 37) 



In main storage 



Control is returned to the caller. 



H 



CALL or 
branch 
(SVC 45) 



In main storage 
(Segment was 
requested via SEGWT) 



The caller's ENTAB is altered to prepare for a 
future branch to the same external address without 
entry to the Overlay Supervisor. Control is 
given to the requested segment at the specified 
address. 



H 



CALL or 
branch 
(SVC 45) 



Not in main storage 



Needed segments are loaded. When loading is 
complete r the reamining processing is the same as 
in 4. 



Figure 25. Types of Overlay Supervision Processing 



Conditions 



Resultant Processing by IEWSZOVR 



-H 



Requested segment in main 
storage (indicator 10) . 



If entry is for a SEGWT request, control is 
returned to caller. If entry is for CALL or 
branch, ENTAB entries are altered to provide 
future entry to segment. 



Requested segment is not in 
main storage (indicator 11) . 



Sets indicator to show "loading scheduled" (01) 
and continues the scan. Determines if the preced- 
ing entry is for a segment in the path of the 
requested segment. 



-H 



The preceding entry is for a 
segment in the path of the 
requested segment. 



Checks status indicator of preceding entry to 
determine if its segment is in main storage. 
(Next step is 5 or 6.) 



H 



f- 



The preceding entry is for a 
segment not in the path of the 
requested segment. 



Preceding entry is for a seg- 
ment in the path, and indi- 
cates its segment is in main 
storage. 



6. Preceding entry is for a seg- 
ment in the path, and indi- 
cates its segment is not in 
main storage. 



Sets status indicator of preceding entry to "not in 
main storage" (11) in preparation for overlaying 
the segment. Continues scan. 

Scan is stopped. The assumption is that all seg- 
ments in the path of the requested segment are 
in main storage (except the requested segment 
itself) . 
-I 

Sets the status indicator of the entry whose 
segment is in the path to "loading scheduled" 
(01) and continues the scan. 



L 



Figure 26. Processing of Segment Table Entries 
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Adjusting an ENTAB to Permit Unassisted 
Branches to Loaded Segments 

When module IEWSZOVR is entered after an 
SVC 45 interruption caused by a CALL or 
branch instruction, it alters the caller's 
ENTAB when it has determined that the 
requested segment is in main storage, or 
when it has loaded the segment. It adds 2 
to the displacement (DISP) field of the 
ENTAB entry through which the branch to the 
SVC 45 instruction was routed (see Figure 
24, Step B) . When the caller executes 
another branch to this ENTAB entry, the SVC 
45 instruction will be bypassed, and con- 
trol will be given to the second field of 
the last ENTAB entry (see Figure 24, Step 
B-l) . Execution of the instruction in this 
field will cause general register 15 to be 
loaded with the value assigned to the 
address constant (in the example, the 
address of FOX) . A branch to that location 
in the requested segment will then be 
executed. 

All entry tables in the same overlay 
region that have been altered to bypass the 
SVC 45 instruction are chained together in 
a "caller chain. " A pointer to the last- 
altered entry table is placed in the seg- 
ment table. When a segment is to be over- 
laid, module IEWSZOVR uses the appropriate 
caller chain to reset all modified entry 
tables that refer to the segment to be 
overlaid. Thus, an unassisted branch can- 
not occur to a segment that is no longer in 
main storage. The resetting of ENTAB 
entries in a caller chain accompanies the 
processing shown for condition 4 of Figure 
26. 



PASSING OF CONTROL 

The last function of the Overlay Super- 
visor is to pass control. Control is given 
to the requested segment or returned to the 
calling segment, depending on the type of 
invoking instruction (SEGLD, SEGWT, CALL, 
or branch). See Figures 24 and 25. 

Branching to a Segment in Main Storage 

When a segment is loaded into main 
storage, because of an implicit call (a 
branch through an ENTAB) , the displacement 
(DISP) field in the ENTAB entry through 
which the branch was routed is increased by 
2 (Figure 24, Step B-l). When the overlay 
program executes another branch to this 
ENTAB entry, the SVC instruction is 
bypassed, and control is given to the 
second field of the last ENTAB entry. 
Execution of the instruction in this field 
causes general register 15 to be loaded 



with the main storage address assigned to 
the indicated symbol. A branch to that 
location is then executed. 

A caller is an ENTAB entry that assisted 
in routing a branch from a segment to an 
entry point in a segment lower in the path. 
ENTAB entries that have been modified to 
bypass the SVC instruction are chained 
together in a caller chain (Figure 27). 
These entries are chained only if the 
called and calling segments are located in 
the same region. Chaining is accomplished 
by placing a pointer to (address of) the 
modified ENTAB entry into the caller field 
of the SEGTAB when the segment is brought 
into main storage. If this segment is 
requested again, the contents of the SEGTAB 
caller field (a pointer to a previous call- 
er) is placed into the previous caller 
field of the referred to ENTAB entry, and a 
pointer to this ENTAB entry is placed in 
the caller field of the SEGTAB. In this 
way, a chain is created that begins at the 
SEGTAB entry and points to all the ENTAB 
entries (in the same region) that were 
modified (+2) to bypass the SVC 45 instruc- 
tion. When the segment is to be overlayed, 
the caller chain is used to reset all of 
the modified ENTAB entries in the chain. 



Branching to a Segment Not in Main Storage 

When an overlay program branches to a 
segment not in main storage, control is 
passed to the applicable ENTAB (step A of 
Figure 24). The branch instruction in the 
ENTAB passes control to an SVC instruction 
contained in the first field of the last 
ENTAB entry (step B) . The SVC instruction 
causes an SVC interruption, and passes con- 
trol to the SVC handler and then to the 
overlay supervisor (step C) . The overlay 
supervisor uses a pointer in general 
register 15 to obtain the information 
required to: 

• Determine the number of the requested 
segment from the ENTAB. 

• Determine the status of the requested 
segment from the SEGTAB. 

• Pass control to the requested segment 
at the entry point specified by the 
address of the entry point field in the 

ENTAB. 

After the segment is loaded, control is 
returned to the second field of the last 
ENTAB entry, the instruction following the 
SVC (step D) . When the load and branch 
instructions have been executed, control is 
passed to the correct entry point. 
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Figure 27. Chain of ENTAB Entries Used to Branch to a Segment 
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RECORDING/RECOVERY SERVICES 



Operating System Re cording /Recovery rou- 
tines are optional control program routines 
which may be selected during system genera- 
tion. They handle malfunctions of the 
central processing unit (CPU), in main 
storage, in a channel, and of devices, 

Recording/Recovery routines are divided 
into two groups: System Environment Re- 
cording and Recovery Management, Recovery 
Management includes: 

• Machine-Check Handler (MCH) , described 
in the appropriate model-dependent 
Machine-Check Handler Program Logic 
Manuals. 

• Channel-Check Handler (CCH) , described 
in the Input/Output Supervisor, Program 
Logic Manual . 

• Alternate Path Retry (APR) , described 
in the Input/Output Supervisor . Program 
Logic Manual . 

• Dynamic Device Reconfiguration (DDR) , 
described in the Input/Output Supervi- 
sor , Program Logic Manual . 



MACHINE-CHECK ROUTINES 

The following routines service machine- 
check interruptions: 



SERO 



which records information about the 
error and then places the system in a 
wait state. 



SER1 



which records information about the 
error and attempts to associate the 
error with a task. If it can do this, 
it abnormally terminates the task and 
allows the system to continue 
operation. 



MCH 



which records information about the 
error and attempts to recover the sys- 
tem from the adverse effects of the 
error . 

For the Model 65, any one of these three 
routines may be selected during system 
generation. For the Model 40, 50, and 75 
either SERO or SER1 is used by default. 
For the System/360 Model 65 Multiprocessor 
and Model 85 and the System/370 Models 135, 
145, 155, and 165, MCH is standard. The 
version used by default depends on the 



model (or models) specified, and on the 
size of the system (see System Generation ). 

CHANNEL-CHECK HANDLER 

The channel-check handler (CCH) may be 
selected during system generation for 
System/360 Models 65 and 75. CCH is auto- 
matically included for System/360 Model 85 
and System/370 Models 135, 145, 155, and 
165. CCH supports the stand-alone 2860, 
2870, and 2880 channels and the integrated 
145 and 155 channels. 

CCH aids recovery from channel errors 
(channel control checks and interface con- 
trol checks) by providing channel error 
information to IBM-supplied, device- 
dependent error-recovery procedures. CCH 
also builds a record entry which is later 
written on SYS1.LOGREC by the outboard 
recorder of the I/O supervisor. 

The outboard recorder (see the Input/ 
Output Supervisor, Program Logic Manual ) 
issues an SVC 76 instruction (IFBSTAT) to 
write the record on SYS1.LOGREC. IFBSTAT 
issues a GETMAIN macro instruction, an ENQ 
macro instruction specifying SYS1.LOGREC, 
and an EXCP instruction to write the record 
on that data set. In MFT with subtasking, 
the main storage for all reguest blocks is 
allocated from the 544-byte system error 
task partition in the nucleus. Handling of 
main storage is done by IEAMSERB. In MFT 
without subtasking, this main storage is 
obtained from the user's partition as 
opposed to System Queue Area in MVT. If 
the error task is invoked while the user 
has control, this error task will need up 
to 544 bytes in the partition to format and 
write a record on SYS1.LOGREC. 



ALTERNATE PATH RETRY ROUTINE 

Alternate Path Retry (APR) allows an I/O 
operation that has developed an error on 
one channel to be retried on another chan- 
nel (if another channel is assigned to the 
device performing the I/O operation) . APR 
accomplishes this by causing channel- 
detected errors to be retried in a selec- 
tive manner on the available paths to a 
device. As paths are found to be inopera- 
tive, they are marked offline, thus pre- 
venting unnecessary retry from being 
initiated to the failing paths. 

APR also provides the capability to VARY 
a path to a device online or offline, using 
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the VARY PATH command. The VARY PATH com- 
mand processor is part of the Master Sched- 
uler (SVC 34). The last path to a device 
will not be varied offline. 

APR is not model- dependent. Four paths 
to each device are supported; teleprocess- 
ing paths are not supported. 



ENTRY TO RECORDING/RECOVERY ROUTINES 

When a machine- check interruption 
occurs, the machine-check new PSW is 
loaded. This causes control to pass 
directly to the Recording/Recovery routine 
which was selected during system 
generation. 



DYNAMIC DEVICE RECONFIGURATION ROUTINE 

Dynamic Device Reconfiguration (DDR) 
allows a demountable volume to be moved 
from one device to another, and reposi- 
tioned if necessary, without abnormally 
terminating the affected job or reperform- 
ing IPL. A request to move a volume may be 
initiated by the operator with the SWAP 
command. The SWAP command processor is 
part of the Master Scheduler (SVC 34). 

The system may request a SWAP after a 
permanent I/O error for non-SYSRES devices 
or after an error in a system fetch opera- 
tion for SYSRES devices. DDR is not 
model- dependent. 



When an I/O interruption occurs because 
of a channel error, the I/O new PSW is 
loaded. This causes control to pass to the 
I/O FLIH and then to the I/O Supervisor. 



If the Channel-Check Handler option was 
not selected during system generation, the 
I/O Supervisor enters the SER Interface 
subroutine (SERR04) within the I/O Supervi- 
sor. This routine loads the machine-check 
new PSW. 



If the Channel-Check Handler was 
selected during system generation, the I/O 
Supervisor enters the Channel-Check Handler 
Interface within the I/O Supervisor. 



SYSTEMS WITHOUT RECORDING/RECOVERY ROUTINES 

A machine check or I/O interruption 
caused by an equipment malfunction places 
in a wait state those IBM System/360 models 
that do not have Recording/Recovery rou- 
tines. A message is issued on the console 
telling the operator to load the System 
Environment Recording, Editing, and Print- 
ing (SEREP) program. SEREP is a model- 
dependent, stand alone diagnostic program. 
Its use is described in the Operator's 
Guide. 



When a permanent I/O error is indicated 
(after retry by the device-dependent error- 
recovery procedures of IOS), the OBR/SDR 
routine is entered to record the error. 

If DDR was selected during system 
generation, the OBR/SDR routine enters DDR 
after recording the permanent I/O error. 
When the permanent I/O error occurs on a 
system fetch operation, the DASD ERP or 
FINCH enters DDR SYSRES before OBR/SDR 
receives control (if DDR SYSRES was 
selected during system generation) . 
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CHECKPOINT/RESTART 



The CHECKPOINT and RESTART service rou- 
tines minimize the amount of time wasted 
when a program abnormally terminates. For 
example, CHKPT macro instructions may be 
used to divide the program into sections. 
When the program abnormally terminates, it 
can be restarted immediately ( automatic 
restart ) or it can be restarted later by 
the programmer ( deferred restart ) • 

If abnormal termination occurs in the 
first section of a program, restart begins 
at the beginning of the step ( Step 
Restart ) . If abnormal termination occurs 
in any other section, restart may begin at 
the beginning of that section ( Checkpoint 
Restart ) . Checkpoint restart eliminates 
the need to rerun sections of a program 
that have already run successfully. 

If a program is coded using three CHKPT 
macro instructions, it is divided into four 
sections (see Figure 28). If abnormal ter- 
mination occurs in section 3, an automatic 
checkpoint restart begins at CHKPT B (if 
the programmer has requested automatic 
restarts) . 

The CHECKPOINT routine is called direct- 
ly when a problem program issues a CHKPT 
macro instruction. The RESTART routine is 
called by a job management program when a 
restart is scheduled. 



Section 4 contains a list of CHECKPOINT/ 
RESTART SVC Modules and Register Usage 
Table. Section 5 contains the format of 
records used by CHECKPOINT/RESTART. 



Problem Program 



RESTART 
■ Begins — 
Here 



If Abnormal 

■ Termination — 

Occurs Here 



Figure 28. Problem Program Checkpoints 



62 



DEVICE INDEPENDENT DISPLAY OPERATOR CONSOLE SUPPORT (DIDOCS) 



Device Independent Display Operator Con- 
sole Support (DIDOCS) is an option of the 
MFT control program, DIDOCS provides 
uniform operator console services for the 
following display console devices: 

• 2250 Display Unit, Models 1 or 3 

• 2260 Display Station, Model 1 with 2848 
Display Control, Model 3 

• Model 85 CRT Display 

• Model 165 CRT Display 

Display Console Support takes advantage 
of device-dependent features of each dis- 
play device (such as the use of the light 
pen on the 2250 for message deletion) • The 
DIDOCS routines receive control from MCS 
when one of the following events occurs for 
a display console: 

• An attention caused by the operator 

• Console switching 

• I/O completion 

• A WTO, WTOR, or command 

o A Delete Operator Messages (DOM) 
request 

• A Timer Interruption 

• Status Display on the Queue 

DIDOCS support comprises the following 
routines: 

• DIDOCS Processor routines (IGC5107B, 
IGC5Z07B, IGC6107B, and IGC6Z07B) - 
provide an interface between DIDOCS and 
MCS, The Processor routines receive 
control from MCS when an operator or 
system request is entered that requires 
processing by the DIDOCS routines. If 
the console involved in the request has 
a transient DCM, Processor 0, Load 1 
(IGC6107B) receives control. Processor 
0, Loads 1 and 2 provide transient DCM 
swapping and permanent PFK update sup- 
port, and then pass control to Proces- 
sor 1 (IGC5107B) . Processor 1, Load 1 
receives control either from Processor 
or directly from MCS (when the requ- 
est involves a console that has a resi- 
dent DCM). Processor 1, Loads 1 and 2 
route control to other display console 
routines as required to process the 
request. 



• Open/Close routine (IGC5G07B) - Opens 
and closes display console device. 

• 2250 I/O 1 and 2 routines (IGC5P07B, 
IGC5Q07B) - Handles input/output opera- 
tions for the 2250 Display Unit. 

• 2260 I/O 1 and 2 routines (IGC5R07B) - 
Handles input/output operations for the 
2260 Display Station. 

• Model 85 I/O routine (IGC5H07B) - 
Handles input/output operations for the 
Model 85 and Model 165 CRT Display used 
as an operator console. 

• Asynchronous Error routine (IGC5C07B) - 
Initializes DCM on an OPEN; blanks the 
screen and displays an appropriate 
error message for the operator. If a 
permanent error occurs, it passes con- 
trol to MCS for console switching. 

• Message 1, 2 # and 3 routines (IGC5D07B, 
IGC5E07B, IGC6D07B) - Contain all mes- 
sages used for Display Console Support. 

• Display 1, 2, and 3 routines (IGC5207B, 
IGC6207B, IGC5307B) - Write all mes- 
sages from the Operating System to the 
operator except those to be deleted and 
status display messages and mark mes- 
sages according to their descriptor 
codes . 

• Roll Mode routine (IGC5J07B) - Removes 
messages from the screen at interval 
specified by the operator. 

• Command routine (IGC5407B) - Analyzes 
type of command in entry area and takes 
appropriate action, or passes control 
to another Display Console Support rou- 
tine for action. 

• Options routine (IGC5A07B) - Analyzes 
CONTROL command entries specifying the 
S operand to determine their legitima- 
cy. If legitimate, this routine 
changes the screen options as requested 
by the operator and routes control to 
another Display Console Support routine 
as required. 

• Delete 1, 2* 3, and 4 routines 
(IGC5607B, IGC5707B, IGC5807B, 
IGC5907B) - Erase answered WTOR mes- 
sages from the screen as well as mes- 
sages specified for deletion by the 
operator (CONTROL command, light pen, 
and cursor) , or by the system (DOM 
macro instruction) . 
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• Light Pen/Cursor Service routine 
(IGC5F07B) - Analyzes the type of func- 
tion indicated by light pen or cursor 
operations and routes control to the 
appropriate Display Console Support 
routine, 

• PFK 1 and 2 routines (IGC6A07B and 
IGC6B07B) - Analyze and enter commands 
requested by the depression of a PFK 
key or by a light pen selection of a 
displayed PFK number. These routines 
also process requests to define or 
redefine the commands associated with 
PFK keys. 

• Timer Interpreter routine (IGC5K07B) - 
Analyzes timer intervals and passes 
indicators to the Processor routine to 
notify it as to which, if any, of the 
display consoles are ready to be 
rolled, assuming roll mode has been 
specified for one or more consoles. 

• Status Display Interface routines 1 
through 7 (IGC6L07B; IGC6M07B; 
IGC6N07B; IGC6O07B; IGC6P07B; IGC6Q07B; 
IGC6T07B) - Process multiple-line WTO 
requests and status displays to be dis- 
played on an operator console. 

• Cleanup routine (IEECVFTG) - Removes 
status displays from the message queues 
and reinitializes the screen area con- 
trol blocks (SACBs) , when a console 
undergoes a status change. 

The following control blocks are used by 
Display Console Support routines: 

• Communication Task Extended Save Area 
(CXSA) - Control block with the address 
of the UCM entry. MCS places the 
address of this control block into 
register 1 when it passes control to 
the Display Console Support routines. 

• Unit Control Module Entry - Control 
area in Unit Control Module (UCM) with 
the addresses of a block of WQE point- 
ers, UCB, DCM, and I/O Blocks. The UCM 
entry provides access to all informa- 
tion required by a display. 

• Write Queue Element (WQE) - Messages on 
the output queue to be written. 

• Unit Control Block (UCB) - Attention 
information . 

• Display Control Module (DCM) - Console 
screen and support interface 
information. 

• Storage Utilization Block (SUB) - Con- 
trol information used by DIDOCS, RMS 
channel programs, and (if transient 
DCMs or PFK definitions are included in 



the system) direct access I/O informa- 
tion. There is only one SUB in the 
system. 

• I/O Blocks - Status of device. 

The DCM is unique for Display Console 
Support. The support requires one base DCM 
of 124 bytes, plus a unit DCM for each dis- 
play operator console in the system. The 
size of each unit DCM varies according to 
the type of device being used. 

The base DCM contains executable code to 
handle timer functions when in roll mode. 

Each unit DCM is divided into two sec- 
tions: a resident section and a section 
that may or may not be resident, at the 
user's option. The resident portion of the 
DCM (RDCM) contains screen control informa- 
tion and the address of the main storage 
area assigned to the optionally transient 
portion of the DCM (if the optionally tran- 
sient portion of the DCM is actually tran- 
sient, the main storage area addressed by 
the RDCM may be used by the transient DCMs 
of several consoles). 

The RDCM may also contain one or more 
screen area control blocks (SACBs), which 
contain information about each status dis- 
play area defined for the console - s screen. 

The optionally transient portion of the 
DCM (TDCM) contains two sections: the 
device independent section and the device 
dependent section. The device independent 
section contains: 

• DOM addresses 

• CCW area 

• Input area 

• Delete request buffer 

• Processor name 

• Option values 

• Communication bits 

• Field sizes for dependent section 

The dependent section includes the fol- 
lowing fields: 



Field 
Screen Control Table 
Screen Image Buffer 
DOM ID Numbers 
Buffer Address Table 
CCW Chain for RMS 
Secondary Screen Control 
Table 



Number of Bytes 



2250 


2260 


M85 


94 


16 


60 


3848 


960 


2800 


188 


32 


120 


10 


6 


8 


48 


32 


42 



47 



30 
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TRACING FACILITIES 



TRACE TABLE FACILITY 

The Trace Table facility is an optional 
facility that may be specified during sys- 
tem generation. The facility provides a 
record of system conditions at the time of 
the following system events: 

• SVC interrupts 

• I/O interrupts 

• Start I/O operations 

o Dispatcher task switches 

Each of the events is recorded in the 
Trace Table that is built in the nucleus by 
Trace routine IEATRC. Most entries contain 
the old PSW, the contents of registers 0, 
1, and 15, and the current TCB address. 
When the Trace Table is filled, the Trace 
routine overlays old entries with new 
entries beginning with the oldest entries. 
For the format of the Trace Table, refer to 
Section 5, "Data Areas." 



IEATRC 

The Trace routine is resident in the 
nucleus and is loaded during nucleus 
initialization. The Trace routine is 
invoked by the SVC First-Level Interrupt 
Handler (SVC FLIH) , the I/O FLIH, and the 
Dispatcher. When entered, the routine 
records the event in the Trace Table. 



GENERALIZED TRACE FACILITY 

The Generalized Trace Facility (GTF) is 
invoked as a system task when the operator 
issues the START command. When GTF is 



active, the supervisor Trace Table facility 
(a system generation option) is inhibited 
until GTF is stopped. When starting the 
GTF task, the operator may select to record 
the trace data either in main storage or in 
the SYS1. TRACE data set on an external 
device specified on the IEFRDER DD state- 
ment in the GTF cataloged procedure. 

When the internal storage option has 
been selected, the data recorded for each 
event class is comparable to that recorded 
by the Trace Table facility. The event 
classes recorded are: 



Event 
Class 

2 

3 

4 

5 

D 



I/O Interrupts 
SVC Interrupts 
Dispatcher task switches 
Start I/O operations 
External and Program Check 
Interrupts 



When the external storage option has 
been selected, the data recorded is more 
comprehensive and may include user-supplied 
trace data. Also, the operator may specify 
events within an event class, such as: I/O 
interrupts from specific devices, only cer- 
tain SVCs, etc. 

The GTF routines are entered from the 
interrupt handlers and the dispatcher when 
a HOOK macro instruction is issued, or from 
a user's program when a GTRACE macro 
instruction is issued. The macro instruc- 
tion specifies the events to be recorded. 
The termination routines use the HOOK macro 
instruction to temporarily suspend GTF 
tracing, or to terminate GTF processing. 
For a more comprehensive discussion of the 
Generalized Trace Facility, refer to the 
Service Aids Logic, Program Logic Manual . 
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SPECIAL FEATURES 



EXTENDED PRECISION FLOATING POINT SIMULATOR 

The extended precision floating point 
simulator provides each System/360 and 
System/370 CPU with the capability of pro- 
cessing all of the eight extended precision 
floating point arithmetic instructions. 
The System/360 Models 85 and 195 and the 
System/370 models (with the extended preci- 
sion feature) provide hardware support for 
all of the extended precision floating 
point instructions except the divide. The 
other System/360 models provide no hardware 
support of these instructions. Depending 
on the CPU, the supervisor simulates execu- 
tion of the divide instruction or all of 
the extended precision floating point 
instructions : 



Instruction 
Add normalized 
(extended) 



Divide 
(extended) 

Load Rounded 
(extended to long) 

Load Rounded 
(long to short) 

Multiply 

( long/ extended) 

Multiply 
(long/extended) 



Assembler Operation 
Mnemonic Code 
AXR 36 



LRDR 



LRER 



MXD 



MXDR 



25 



35 
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27 



6646) . The three modules which comprise 
the simulator are: 

• IEAXPSIM, which must be entered first 
to determine which of the other two 
modules is appropriate for the CPU. 

• IEAXPALL, which simulates the 8 
extended precision floating point 
instructions on System/360 CPUs that do 
not have hardware support for the 
instructions. 

• IEAXPDXR, which simulates only the DXR 
instruction on the System/360 Models 85 
and 195 and System/ 370 models. 



SYSTEM MANAGEMENT FACILITY 

The supervisor performs the following 
functions if the System Management Facility 
(SMF) feature has been selected at system 
generation: 

• Maintains a record of system wait time. 

• Assists in handling time limit 
expirations. 

• Counts and records the number of 
references to user data sets. 

• Controls the output limit for SYSOUT 
data sets. 

• Records the number of 2048-byte blocks 
of storage assigned to a user program. 



Multiply 
(extended) 



MXR 
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RECORDING SYSTEM WAIT TIME 



Subtract Normalized 
(extended) 



SXR 



37 



♦The divide instruction is simulated by the 
DXR macro instruction. See the publica- 
tion Supervisor Services and Macro 
Instructions. 



Relationship to the Operating System 

The attempted execution of any of the 
eight extended precision floating point 
instructions that are not supported by CPU 
hardware causes a program interruption. 
The failing instruction is simulated by the 
supervisor if the user has provided the 
necessary linkage to the extended precision 
floating point simulator via the SPIE macro 
instruction (see Supervisor Services , GC28- 



Whenever the Dispatcher puts the system 
in the wait state, it places the contents 
of the interval timer in the first word of 
a special save area, SYSWSAVE. When an 
external or input/output interruption ends 
the wait state, the interruption handlers 
call the SMF Wait Time Collection routine. 
This routine reads the interval timer again 
and compares its value with the value 
stored by the Dispatcher to determine the 
elapsed system wait time. It then adds 
this elapsed time to the value in the 
second word of SYSWSAVE, giving the accumu- 
lated wait time for the system. 

When a supervisor 10-minute timer 
interval expires, the Timer SLIH routine 
reads out the value in the second word of 
SYSWSAVE, which represents the total system 
wait time for the 10-minute interval. This 
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value is added to a field in the system 
management control area, SMCAWAIT + 4. 

Each time the Step Termination routine 
of Job Management is entered, the total 
wait time recorded in the system management 
control area is checked. If it is nonzero, 
a system 10-minute wait record is 
generated. 



HANDLING TIME/OUTPUT LIMIT EXPIRATION 

Whenever a job, step, or wait time limit 
expires, the SMF Time Limit Expiration sub- 
routine of the Timer SLIH routine passes 
control to a user time limit expiration 
routine. The user routine determines 
whether or not to grant a time limit exten- 
sion. If an extension is granted, the SMF 
Time/Output Limit Expiration routine resets 
the TQE. If no extension is granted, the 
routine prepares for step termination in 
case of job/step time expiration, or pre- 
pares for abnormal termination in case of 
wait time expiration. 



COUNTING REFERENCES TO USER DATA SETS 

Whenever a reference is made to a user 
data set, the EXCP Counting routine records 
the reference in an EXCP counter. There is 
a counter for each data set/device combina- 
tion. The counters are part of the TCT I/O 
Table segment of the timing control table. 



CONTROLLING OUTPUT LIMIT FOR SYSOUT 

Whenever a reference is made to a SYSOUT 
data set, the EXCP Counting routine checks 
for an output limit in the TCT I/O Table 
segment of the timing control table. If an 
output limit is specified, it is compared 
to the updated EXCP counters. 

If the output limit is exceeded, the SMF 
Output Limit Expiration routine gives con- 
trol to a user output limit routine. The 



user routine determines whether or not to 
increase the limit. If the increase is 
granted, the SMF Output Limit Expiration 
routine increases the output limit speci- 
fied in the TCT I/O Table. Otherwise, the 
routine prepares for abnormal termination. 



RECORDING STORAGE BLOCKS ASSIGNED TO USER 
PROGRAMS 

Whenever the main storage supervision 
routines allocate or release 2048-byte 
blocks of storage within a region assigned 
to a user program, the following informa- 
tion is recorded in the timing control 
table: 

• The highest address currently allocated 
from the bottom of the region. This 
address is called the "low water mark," 
or LWM. 

• The lowest address currently allocated 
from the top of the region. This 
address is called the "high water 
mark," or HWM. 

« The smallest amount of space within the 
region that has been available to this 
program at any one time (the minimum 
difference between the LWM and the 

HWM). 

• The size of the region. 

o The number of borrowed 20 4 8 -byte blocks 
currently assigned to the program (if 
the rollout feature is present) . 

« The highest number of 2 048 -byte blocks 
that have been assigned to the program 
at any one time (if the rollout feature 
is present) . 

If IBM 2361 Core Storage is included in 
the system, storage information is main- 
tained both for processor storage and for 
2361 Core Storage. 
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SECTION 3: PROGRAM ORGANIZATION 



The following text and the flowcharts at 
the end of the section describe the rou- 
tines that perform the management and ser- 
vice functions of the supervisor. The 
organization of this section corresponds to 
the organization of Section 2. Modules 
that perform similar functions (interrup- 
tion supervision, task supervision, etc,) 
are grouped. Module names facilitate use 
of program listings (see "Section 4: 
Module Directory") and descriptive names 
provide reference to the "Method of Opera- 
tion" section (Section 2). 



INTERRUPTION SUPERVISION ROUTINES 

The interruption supervision routines 
provide the interface between the problem 
programs in main storage and the other 
supervision routines. All services 
requested of the supervisor by the user or 
by other routines in the control program 
are scheduled by interruption supervision. 
When such a request is made, control is 
automatically given to one of the four 
interruption handling routines: supervisor 
call, timer/ external, input/output, or pro- 
gram check. These routines determine the 
service requested and pass control to other 
supervisor routines or to user- supplied 
routines to perform that service. A 
machine check causes control to be passed 
directly to recording or recovery routines 
if these are included in the system. 



SVC FIRST-LEVEL INTERRUPTION HANDLER 
(IEAAIHOO) CHART AA 



The SVC FLIH receives control as a 
result of a hardware-generated branch from 
the routine that issued the SVC instruc- 
tion. After saving registers, a HOOK macro 
instruction is issued to inform the Genera- 
lized Trace Facility (GTF) to record the 
SVC interruption, provided the GTF is 
active. If GTF is not active, the SVC 
interruption is recorded in the optional 
Trace Table (a system generation option). 
The SVC code is then tested to determine if 
it is a valid request. If the SVC code is 
not IBM- supplied, or no entry for the SVC 
code exists in the SVC Table, the SVC FLIH 
issues an SVC 13 (ABEND) instruction to 
abnormally terminate the task that issued 
the SVC request. If the code is valid, the 
SVC FLIH loads register 3 with the address 
of the Communication Vector Table, register 
4 with the address of the TCB for the cur- 
rent task (pointed to by OLD at IEATCBP+4 
in the Dispatcher) , and register 5 with the 



address of the current request block 
(pointed to by TCBRBP in the current TCB). 
If the request is for a type 1 SVC routine 
(the ESA for the entry in the SVC Table is 
b'OOO'), the type 1 indicator is set, and 
control is passed to the appropriate SVC 
routine. The return address for the type 1 
SVC routine is that of the Type 1 SVC Exit 
routine, which follows the SVC FLIH in the 
module IEAAPS. 

If the requested routine is other than a 
type 1 SVC, the SVC FLIH tests for a type 2 
or 3 SVC request and branches to the SVC 
Second-Level Interruption Handler (SLIH) . 
The first instruction in the SVC SLIH is a 
conditional branch dependent upon the con- 
dition code set by this test. 



TYPE-1 SVC EXIT ROUTINE (IEAAIHOO) CHART AA 

This routine is entered by a branch from 
a type 1 SVC routine, including the SVC 
FLIH, and provides return linkage to the 
routine that issued the SVC, or linkage to 
the Dispatcher if a task switch is neces- 
sary. The type 1 SVC Exit routine resets 
the type 1 indicator to and restores the 
registers from the SVC save area. If the 
pointers in the 2-word field IEATCBP in the 
Dispatcher contain the address of the same 
TCB (indicating that no task switch is 
necessary), if the pseudo- disable switch is 
set, or if the calling task is disabled for 
interruptions, the Exit routine loads the 
SVC Old PSW to return control to the cal- 
ling routine. Otherwise (for example, if 
the TCB addresses are not the same and the 
task is enabled for all interruptions), a 
task switch is necessary. Registers 10 
through 1 are saved in the current TCB, the 
SVC Old PSW is saved in the current request 
block, and control passes to the 
Dispatcher. 



SVC SECOND-LEVEL INTERRUPTION HANDLER 
(IEAATA00) CHART AB 



The SVC SLIH receives control from the 
SVC FLIH to further process requests for 
types 2, 3, and 4 SVC routines. The condi- 
tion code set by the SVC FLIH prior to 
passing control to the SVC SLIH is used to 
separate type 2 requests from type 3 and 4 
requests. The SVC SLIH saves the SVC Old 
PSW in the requester's RB. The SVC SLIH 
uses GETMAIN (IEAAMS) to obtain main 
storage for a supervisor request block 
(SVRB) , which the SVC SLIH initializes and 
places on the RB queue of the TCB for the 
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requesting routine. If the request is for 
a type 2 SVC routine, the SVC SLIH branches 
directly to the requested routine. If the 
routine is a nonresident type 3 or 4 SVC, 
the SVC SLIH uses FINCH to load the routine 
into the SVC transient area if necessary 
before branching to the routine. Upon 
normal completion of the requested SVC rou- 
tine , control is returned to the SVC SLIH 
which issued an SVC 3 instruction to pass 
control to the EXIT routine for type 2, 3, 
and 4 SVC routines. 

Special processing occurs when main 
storage is not available for the SVRB. If 
the request originated in ABEND, and the 
current task is a subtask, the job step is 
terminated. In this case, the entire TCB 
queue is searched, and the highest priority 
ready task is located. The address of its 
TCB is placed in NEW (IEATCBP in the Dis- 
patcher) , and the SVC SLIH branches direct- 
ly to the Dispatcher. 

For other cases where there is no space 
within the partition for an SVRB, a pool of 
3 SVRBs is provided within the SVC SLIH for 
initial and recursive ABEND processing. 
When in use, the fullword (USERTCB) follow- 
ing the third SVRB points to the TCB of the 
abnormally terminating task. When not in 
use, the fullword is set to zero. The use 
of each SVRB within the pool is indicated 
by the RBSIZE field; indicates not in use. 

The SVRB pool cannot be used concurrent- 
ly by more than one task. If the pool is 
not available and main storage has not al- 
ready been stolen, the SVRB is created in 
the beginning of the partition and process- 
ing continues as if main storage had been 
available (above) . If main storage has al- 
ready been stolen, the wait count in the 
request block is incremented, the Damage 
Assessment routine (DAR) dispatchability 
bit is set. The Subsystem Purge routine 
determines if the request is from GTF. If 
it is, GTF is disabled to prevent a system 
task from causing a system failure. Upon 
return, the resume PSW is enabled, the 
pointer NEW (IEATCBP) is set to indicat- 
ing that a task switch is necessary and the 
SVC SLIH branches to the Dispatcher. 



EXTENDED SVC ROUTER (ESR) CHART AI 

The primary function of the Extended SVC 
Router (ESR) is to provide linkage to 
Supervisor Service routines by logically 
extending the routing capability of the SVC 
Interruption Handlers. ESR does this via a 
secondary routing algorithm based on a 
parameter established prior to issuance of 
one of the ESR SVCs (109, 116, or 117). 
The interface provided to the Supervisor 
Service routine invoked by the ESR is 
identical to that provided by the SVC 



Interruption Handlers for Type 1, 2, 3 and 
4 SVC routines except for an additional 
parameter used by the ESR for its routing. 

ESR Processing for Type 1 and 2 Supervisor 
Service Routines 

The Type 1 and Type 2 ESR Supervisor 
Routers are invoked via issuance of the 
Type 1 SVC 116 and Type 2 SVC 117, respec- 
tively. Upon entry to SVC 116 (IGC116) or 
SVC 117 (IGC117), the ESR code in register 
15 is checked to ensure that a correspond- 
ing function exists. If the ESR code does 
not represent a supported function, the 
calling task is abnormally terminated. If 
the ESR code is valid, linkage to the 
appropriate resident supervisor service is 
made by converting the ESR code received in 
register 15 to an index value into an 
internal branch table of V-type address 
constants. The appropriate V-con is loaded 
into register 15 and control is passed to 
the routine via a branch instruction. 
Except for the use of register 15 for input 
of an ESR code, these SVCs (116 and 117) 
are identical to any other SVC routine. 
The same interface is presented to the 
Supervisor Service routines to which ESR is 
routing control as would have been pre- 
sented to them by the SVC Interruption Han- 
dlers had they been invoked directly by an 
SVC number. 

ESR Processing for Type 3 and 4 Supervisor 
Service Routines 

The Type 3 and Type 4 ESR Supervisor 
Service Router is invoked via issuance of 
SVC 109 (IGC109). The ESR code in register 
15 is checked to ensure that it is not 
greater than the highest assigned number. 
If the ESR code is invalid, the caller is 
abnormally terminated. Otherwise, the 
linkage to the appropriate supervisor ser- 
vice routine is made via XCTL. The XCTL 
parameters are developed by converting the 
ESR code passed in register 15 to a 3- 
character EBCDIC number which is appended 
to a prefix (IGC00) to form an ESR name 
(that is, if the binary value in register 
15 is 89, the resultant ESR name would be 
IGC00089). This ESR name represents the 
first load of an SVC and is used as input 
to the XCTL service routine. Control is 
then transferred to the module represented 
by the ESR name via XCTL. Any subsequent 
loads of the Type 4 routine are named by 
incrementing the third and fourth charac- 
ters of the original name (that is, several 
loads would be named IGC00089, IGC01089, 
IGC02089, etc.). 



EXIT (IEAATA00) CHART AC 

EXIT is used by types 2, 3, and 4 SVC 
routines, as well as asynchronous exit rou- 
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tines (STAE, SPIE, etc.) and routines 
entered by supervisor-assisted linkage, to 
return control to the calling routine or to 
pass control to the Dispatcher when a task 
switch is necessary. Because EXIT is a 
type 1 SVC routine and may be entered 
through the SVC FLIH as a result of an SVC 
3 instruction, as well as by a branch, the 
type 1 SVC indicator set by the SVC FLIH 
must be reset to 0. EXIT is itself a link- 
age routine and does not use the type 1 SVC 
Exit routine. 

If the exiting program is a user- 
provided program interruption routine (the 
SVC Old PSW is equal to the Program Inter- 
rupt Old PSW) r the contents of registers 13 
(which contains the resume address) through 
2 are restored from the Program Interrup- 
tion Element (PIE) , the resume address 
saved in the PIE is moved to the SVC Old 
PSW, and the PIE is indicated as reenter- 
able. EXIT loads registers 3 through 13 
from the TCB of the exiting program and 
returns control to the interrupted program 
by loading the SVC Old PSW. 

If the exiting routine is not a program 
interruption routine, EXIT frees all STAE 
control blocks created by the exiting rou- 
tine that do not have the XCTL option spe- 
cified. STAE control blocks are queued 
from the TCBNSTAE field in the TCB. 

If the request block for the exiting 
routine is an IRB or an SIRB, EXIT dequeues 
the top IQE from the IRB. If the IQE has a 
2-byte link field, the I/O Supervisor 
returns it to the queue of available IQEs. 
If the top IQE has a 4-byte link field, it 
is discarded unless there is a NEXAVL f i^ld 
in the IRB, in which case it is returned to 
this queue. If there is another IQE queued 
to the IRB, EXIT initializes the SVC Old 
PSW, places the address of an SVC 3 (EXIT) 
instruction in register 14, and loads the 
SVC Old PSW to return control to the asyn- 
chronous routine. 

If there are no other IQEs on the IRB, 
or if the RB for the exiting routine is not 
an IRB or SIRB, EXIT determines whether the 
RB for the exiting program is the last RB 
on the queue. If not, the RB is dequeued 
and, if it is not a minor LPRB or if its 
use count is 0, its area and that of the 
routine is freed. If the next RB on the 
queue is in a wait state, NEW (IEATCBP) is 
set to 0. EXIT branches to the Dispatcher, 
which determines the routine that is to 
receive control next. 

If the RB for the exiting routine is the 
last RB on the queue and its TCB is for a 
job-step task, EXIT issues an SVC 13 
(ABEND) to normally terminate the task. 
However, if this task has any active sub- 
tasks, or has an ENQ count that is not zero, 



EXIT issues an SVC 13 instruction with the 
appropriate error code in register 1. 

When the normal termination processing 
of ABEND is complete, an SVC 3 instruction 
is issued and processing resumes in EXIT as 
follows. EXIT frees the RB and the area 
for the routine, and provides processing 
for the end-of-task (EOT) exit routine. 
(If the user had not specified an EOT exit 
routine, the system EOT exit routine was 
specified by ATTACH. This routine is part 
of IEAATA00 and issues an SVC 62 (DETACH) 
to free the task and its TCB. The IRB is 
queued to the TCB of the mother task.) 

EXIT removes the TCB from the TCB queue 
and sets NEW equal to OLD. Processing is 
optionally provided for time slicing, ECB 
posting, and job step timing. If POST (for 
ECB processing) did not change the contents 
of NEW, EXIT sets NEW to and branches to 
the Dispatcher. 



TIMER/ EXTERNAL FIRST- LEVEL INTERRUPTION 
HANDLER (IEAAIH00) CHART AD 

The T/E FLIH saves registers 2 through 9 
within the T/E FLIH. A HOOK macro instruc- 
tion is then issued to inform the Genera- 
lized Trace Facility (GTF) routines to 
record the external interrupt, provided 
that GTF is active and that class D mon- 
itoring has been specified. If the system 
is pseudo disabled, registers 10 through 1 
and the T/E Old PSW are saved within the 
T/E FLIH. If the system is not pseudo dis- 
abled, registers 10 through 1 are saved in 
the TCB for the current task (pointed to by 
IEATCB+4 in the Dispatcher), IEAQWAIT is 
used to update the system wait- time values, 
and the T/E Old PSW is stored in current RB 
with the wait bit set off. The T/E FLIH 
determines from the T/E Old PSW the type of 
interruption that occurred, and passes con- 
trol to the appropriate second-level inter- 
ruption handler (external or timer). 

Upon return from the second-level inter- 
ruption handler, the T/E restores registers 
2 through 9 and branches to the Dispatcher 
if the system is not pseudo disabled. If 
the system is pseudo disabled, all regis- 
ters are restored and control is returned 
to the interrupted routine. 



INPUT/OUTPUT INTERRUPTION HANDLER 
(IEAAIH00) CHART AD 



The first instruction of the I/O FLIH is 
a NOP- branch switch, set to a branch by the 
first input/output interruption, allowing 
input/output interruptions, to be processed 
in groups. The first interruption of a 
group causes the I/O FLIH to execute some 
initialization instructions that prevent 
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any further execution of this "first-time 
logic" for successive interruptions in a 
group. Registers 2 through 9 are saved, 
and the subroutine IEAQWAIT is used to up- 
date the system wait-time values stored in 
the Dispatcher. 

If the system is not pseudo disabled, 
the I/O Old PSW is saved in the current RB. 
The wait bit in the I/O Old PSW is set to 
zero (non-wait state) , and registers 10 
through 1 are saved in the TCB's general 
register save area. If the system is pseu- 
do disabled, registers 10 through 1 are 
saved in the interruption supervision 
pseudo-di sable save area, and the I/O Old 
PSW is saved. 

The I/O FLIH branches directly to the 
part of the input/output supervisor that 
handles interruptions. When it regains 
control from the I/O supervisor, the I/O 
FLIH sets the NOP/branch switch to no- 
operation and restores registers 2 through 
9. 

The pseudc disable switch is tested. If 
it is off, the I/O FLIH enters the Dis- 
patcher. If it is on, the I/O FLIH 
restores registers 10 through 1 from the 
pseudo disable save area, and returns con- 
trol to the interrupted routine by loading 
the I/O Old PSW. 



PROGRAM CHECK FIRST- LEVEL INTERRUPTION 
HANDLER (IEAAIH00) CHART AE 

The Program Check FLIH saves all regis- 
ters in the program check save area. An 
immediate branch is made to IHLMCIH to 
determine if the interruption was from 
either a System/370 or a simulated System/ 
360 Monitor Call instruction. If it was, 
the Generalized Trace Facility (GTF) rou- 
tines record the event and return control 
directly to the user's program, or to the 
Dispatcher if a task switch is required. 
Otherwise, the interruption is a valid pro- 
gram check and GTF is used to record the 
interruption and returns control to the 
Program Check FLIH to continue processing. 
Subsequent processing depends on whether a 
program interruption element (PIE) exists. 
A PIE exists if the problem program has 
issued a SPIE macro instruction. If no PIE 
exists, or if the program check occurred in 
a supervisor routine, control passes to 
ABTERM to schedule abnormal termination of 
the task. The PIE contains the address of 
an associated program interruption control 
area (PICA) which contains a mask indicat- 
ing the type of program interruptions that 
the user- provided routine will handle. If 
this program check is not handled by the 
user's routine, control passes to ABTERM to 
schedule abnormal termination of the task. 
Otherwise, the Program Old PSW (at time of 



interruption) and registers 12 through 2 
are moved to the PIE, register 14 is loaded 
with the return address of an SVC 3 
instruction, the address of the user- 
provided routine is stored in the Program 
Old PSW, and control is passed to the rou- 
tine by loading the Program Old PSW. 



DISPATCHER (IEAAIH00) CHART AF 

The second instruction in the Dispatcher 
is a NOP-branch to the Stage 3 Exit Effec- 
tor. If this instruction has been made 
active by the Stage 2 Exit Effector, the 
Dispatcher branches to the Stage 3 Exit 
Effector to schedule requests for system 
asynchronous exit routines. 

Processing by the Dispatcher depends on 
the contents of NEW and OLD. These are one 
word pointers within the Dispatcher at 
IEATCBP and IEATCBP+U respectively which 
contain the addresses of the TCB for the 
task to be dispatched next (NEW) , and the 
address of the TCB for the task which last 
had control (OLD). At system generation, 
both fields point to the first TCB on the 
queue. Other supervisor routines indicate 
to the Dispatcher that a task switch is 
necessary by altering the contents of NEW. 
Upon entry, NEW may be equal to OLD, indi- 
cating that no task switch is necessary; 
NEW may contain an address other than that 
contained in OLD, indicating that the task 
pointed to by NEW is the next one to be 
dispatched; or NEW may be zero, indicating 
that the Dispatcher is to determine which 
task is to be dispatched next. If there is 
a task in the system that is dispatchable, 
the Dispatcher will set both NEW and OLD to 
point to the TCB for that task before pass- 
ing control to it. 

If NEW equals OLD, no task switch is 
necessary. The Dispatcher queues any timer 
queue elements necessary and returns con- 
trol to the current task by loading the 
resume PSW which is contained in the top RB 
on the TCB pointed to by OLD. 

If NEW does not equal OLD, a task switch 
is indicated. The contents of registers 2 
through 9 and the floating-point registers 
are stored in OLD's TCB. If job-step CPU 
timing is included in the system, and OLD's 
TCB has an address in its TCBPIB field, 
(indicating that OLD is not a system task) , 
the Dispatcher queues the job- step timer 
queue element. If necessary, the Dispatch- 
er dequeues timer elements associated with 
the task currently in control. Then it 
determines if NEW equals 0. 

If NEW does not equal 0, it contains the 
TCB address of the task to be given con- 
trol. The Dispatcher sets OLD equal to 
NEW, goes to the trace routine (if pre- 
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sent), or if active, the Generalized Trace 
Facility (GTF) by issuing a HOOK macro 
instruction to record the pending task 
switch. The Dispatcher then restores the 
floating-point registers (if present) • If 
job-step CPU timing is included in the sys- 
tem, the dispatcher determines whether the 
TCB to receive control has a PIB pointer in 
its TCBPIB field. If there is a pointer, 
the task is not a system task, and the Dis- 
patcher queues the job-step timer queue 
element. The Dispatcher then branches to a 
transient area refresh subroutine. Upon 
return, the Dispatcher branches to the task 
pointed to by NEW. 

If NEW equals 0, the Dispatcher must 
examine the TCB queue to determine which 
task should be given control. This 
examination begins with the TCB addressed 
by OLD. (For a task of higher priority 
than OLD to receive control, the address of 
its TCB must be inserted in NEW by a super- 
visory routine) . 

When examining a TCB to determine if its 
associated task should be given control, 
the Dispatcher first determines if the 
request block (RB) of the program executing 
under the TCB is waiting. This is done by 
examining field XRBWT in the RB addressed 
by TCB field TCBRBP. If the RB is not 
waiting, the Dispatcher examines TCB field 
TCBFLGS to determine if the task is dis- 
patchable. If so, the Dispatcher sets NEW 
and OLD to the address of the TCB and 
queues timer elements. Control then passes 
to the new task. 

The Dispatcher does not pass control 
directly to the new task when the TCBRBP 
field for the task to be given control 
addresses an SVRB for a loaded transient 
SVC routine which is no longer present in 
the SVC transient area. In this case, the 
SVC routine was overlaid (before its execu- 
tion completed) by another SVC routine. 
The Dispatcher determines whether the SVC 
routine currently in the transient area is 
the one required for the new task by com- 
paring the contents of the doubleword 
XSNTCC with the XRBNM field of the SVRB. 
(XSNTCC is located in the SVC Second-Level 
Interruption Handler-IEAATAOO, and contains 
the name of the SVC routine currently in 
the transient area) . If the fields are 
indentical, the SVC routine currently in 
the transient area is the one required for 
the new task, and the dispatcher passes 
control to the new task. 

If XSNTCC and XRBNM do not match, the 
Dispatcher prepares to reload the SVC tran- 
sient area with the SVC routine indicated 
in the XRENM field. It issues a branch and 
link to the SVC SLIH for creation and 
initialization of a new SVRB. This SVRB 
represents the refresh request for the SVC 



routine that was overlaid before its execu- 
tion completed. The PSW in the SVRB con- 
tains the address of the FINCH interface 
routine within the Dispatcher. The Dis- 
patcher then examines OLD and NEW again. 
The same conditions exist as before except 
that the top RB on the TCB's queue is the 
SVRB for the FINCH interface subroutine. 
This module branches and links to FINCH 
which loads the requested routine into the 
SVC transient area. Upon return, the Dis- 
patcher branches to the EXIT routine (IEAA- 
TA00) which will dequeue the SVRB for the 
FINCH interface routine, indicate that a 
task switch is necessary, and return con- 
trol to the Dispatcher to dispatch the 
newly loaded SVC routine. 

If the RB for the task is waiting or the 
task is nondispatchable, the task is not 
ready to receive control. The dispatcher 
then examines each TCB lower on the queue 
to determine whether it is ready to receive 
control. This process continues until a 
ready task is found or until the end of the 
queue is reached. 

If no task is able to receive control, 
the Dispatcher sets the resume PSW wait bit 
of the TCB addressed by OLD. This PSW is 
then loaded, placing the CPU in a wait con- 
dition. The resume PSW is located in field 
XRBPSW of the RB addressed by TCB field 
TCBRBP. 

If the System Management Facility is 
included in the system, the Dispatcher 
records the beginning of a system wait 
before loading the RB old PSW. It reads 
the interval timer and stores its value in 
the first word of a special save area, SYS- 
WSAVE. This value is later used by the 
System Management Facility wait time 
collection routine to calculate elapsed 
system wait time. 

Figures 29 and 30 illustrate how control 
is switched, assuming a three partition 
system in which PI is inactive. All tasks 
are dispatchable except task PI. Initial- 
ly, only the communications task and master 
scheduler task are waiting. Because task 
P0 is the highest priority task that is 
dispatchable and not waiting, it is given 
control. Task P0 has already enqueued and 
received exclusive control of a resource 
which task P2 will later enqueue (see 
Figure 30). 

Dispatching the Communications Task and 
Master Scheduler Task 

Figure 29 illustrates how control passes 
to the communications task and master 
scheduler task through the Dispatcher. In 
the example, the communications task 
receives control in order to read a DEFINE 
command from the operator console. 
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Initially, the task in PO has received 
control from the Dispatcher and is execut- 
ing. The operator presses the REQUEST key 
to indicate that he wishes to enter a com- 
mand from the console. An I/O interruption 
is generated and control passes to the I/O 
supervisor which identifies the interrup- 
tion as an attention signal. The I/O 
supervisor then passes control to the con- 
sole interruption routine which issues a 
POST macro instruction. The POST routine 
posts the attention ECB and sets the com- 
munications task RB to a non-wait condi- 
tion. Because the communications task is 
of higher priority than the task in parti- 
tion # the POST routine places the address 
of the communications task TCB in location 
NEW. Control then passes to the 
Dispatcher. 

The Dispatcher gives control to the com- 
munications task which passes control to 
resident device-support routines or issues 
SVC 72 for transient device- support rou- 
tines. The device-support routines read 
the console 1 s command and then issue SVC 34 
to process the command. SVC 34 processes 
some commands completely but must pass con- 
trol to the master scheduler resident com- 
mand processor routine to complete process- 
ing the DEFINE command. SVC 34 issues a 
POST macro instruction to post the master 
scheduler task. The POST routine sets the 
master scheduler RB to a non-wait condition 
and gives control to the Dispatcher. 
Because the master scheduler task is of 
lower priority than the communications 
task, locations NEW and OLD remain 
unchanged and the dispatcher returns con- 
trol to the communications task. 

The communications task issues a WAIT 
macro instruction and waits on an ECB. The 
WAIT routine sets the communications task 
RB in a wait state and sets location NEW to 
0. The Dispatcher then receives control 
and searches the TCB queue. Since the 
master scheduler task is the next ready 
task on the TCB queue, the address of the 
master scheduler TCB is placed in locations 
NEW and OLD, and the Dispatcher passes con- 
trol to the master scheduler. 

The master scheduler completes process- 
ing the DEFINE command and then issues 
WAIT. The WAIT routine sets location NEW 
to and passes control to the Dispatcher 
which searches the TCB queue until it finds 
a task ready to receive control. In Figure 
29, control returns to the task that was 
executing before the operator entered the 
DEFINE command. 



Dispatching Tasks by Partition Priority 

Figure 30 illustrates task switching 
among tasks executing in partitions. 



A. The task in partition PO (task PO) is 
the highest-priority ready task and is 
given control by the Dispatcher. When 
task PO issues a WAIT on an ECB, an 
interruption occurs and control passes 
to the WAIT routine. 



B. The WAIT routine places the RB for 
partition in a wait condition and 
sets location NEW to 0. It then 
passes control to the Dispatcher which 
searches the TCB queue beginning with 
the TCB for partition 0. Since task 
PO is waiting and task PI is not dis- 
patchable, the Dispatcher passes con- 
trol to task P2, the highest priority 
task ready to execute. When task P2 
attempts to request a resource through 
use of the ENQ macro instruction, an 
interruption occurs and control passes 
to the ENQ routine. 



C. The resource is unavailable because 
task PO has already requested it. 
Therefore, task P2 connot continue 
executing. The ENQ routine places 
zero in location NEW and then passes 
control to the Dispatcher which 
searches the TCB queue. The Dispatch- 
er sets the wait bit in the resume PSW 
of task P2. The Dispatcher passes 
control to task P2, placing the CPU in 
a machine wait condition. 



D. While the CPU is waiting, an interrup- 
tion occurs signifying the completion 
of the event for which task PO was 
waiting. The POST routine receives 
control and posts the ECB for task PO 
which is now able to resume control. 
The POST routine places the TCB 
address for task PO in location NEW 
and gives control to the Dispatcher. 
The Dispatcher sets OLD equal to NEW 
and gives control to task PO. When PO 
is finished using the resource that it 
has requested, it issues a DEQ macro 
instruction. 

E. An interruption occurs and the DEQ 
routine receives control. The queue 
element for task PO is removed from 
the resource queue. The next element 
on the resource queue is for task P2. 
The resource is assigned to task P2 
and its RB is placed in a non-wait 
condition. The DEQ routine then com- 
pares the priority of the task which 
has been in control with the priority 
of the task which is now ready. 
Because task PO has a higher priority 
than task P2, location NEW remains 
unchanged. The DEQ routine passes 
control to the Dispatcher which 
returns control to task PO. 
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Dispatching a Task with Time Slicing 

If the time-slicing option is selected 
at system generation in an MFT system 
without subtasking, one or more contiguous 
partitions will contain tasks that share 
CPU time. The number of time- slicing par- 
titions, and the maximum amount of time 
each task will have, are determined by the 
time- slice parameters set at system genera- 
tion. Both may be modified by the DEFINE 
command. 

When a TCB of a partition within the 
time- slice partitions is the highest ready 
TCB, the Dispatcher will share the CPU time 
among all the ready TCBs within the time- 
slice partitions. These TCBs will share 
the CPU until none of the TCBs are dis- 
patchable or a higher priority task is 
ready, at which time the Dispatcher will no 
longer be limited to the time-slicing 
tasks. 

The Dispatcher determines whether the 
tasks are to share the CPU by testing the 
time-slice control element (see Figure 31). 
The TCB of the highest priority partition 
within the time-slice group is addressed by 
the field FIRST; the lowest priority parti- 
tion within the group is addressed by the 
field LAST. The time-slice dispatching 
queue is that portion of the dispatching 
queue starting with the FIRST TCB and end- 
ing with LAST TCB. The Dispatcher stores 
the address of the TCB to next receive con- 
trol in the field NEXT and allows each task 
to run for the interval given in the field 
LENGTH. 

If time-slicing is selected in a system 
with subtasking, two additional fields are 
created within the TSCE, as shown in Figure 
32. In addition to the addresses of the 
first and last TCBs, the priorities given 
to the time- slicing group are included. 
The value for FIRST is the initial dis- 
patching or limit priority of the job step 
TCB in the highest priority partition in 
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Figure 31. Time Slice Control Element 
without Subtasking 



Figure 32. Time Slice Control Element with 
Subtasking 



the time-slice group; the value for LAST is 
one more than the dispatching priority of 
the partition below the LAST partition. 
Any TCB whose dispatching priority falls 
within the range of values from FIRST to 
LAST will be dispatched as a time- slice 
task. 

When time-slicing is selected, the Dis- 
patcher performs functions in addition to 
those explained in the preceding para- 
graphs. The following text describes the 
additional functions. 

NEW Equals OLD and OLD is a Time-Slice 
Task : If the interval has expired (the 
time-slice queue element is not on the 
queue) , the next ready time-slice task must 
be dispatched. The Dispatcher searches the 
time-slice group beginning with the TCB 
pointed to by NEXT in the TSCE through the 
TCB pointed to by LAST. If no task is 
found, the search continues resuming with 
the TCB pointed to by FIRST. When a ready 
task is found, NEXT is updated, the time- 
slice TQE is queued, and the ready task is 
dispatched. If no ready time- slice task is 
found, the Dispatcher searches the TCB 
queue for the highest priority ready task. 
If the interval has not expired, control is 
returned to the interrupted task. 

NEW Equals OLD and OLD is not a Time-Slice 
Task : Control is returned to the inter- 
rupted task. 

NEW Equals and OLD is a Time-Slice Task : 
The Dispatcher removes the time-slice TQE 
from the queue and searches for the next 
ready time-slice TCB as described above in 
"NEW Equals OLD." 

NEW is a Time-Slice Task and OLD is a Time- 
Slice Task : The task represented by OLD, 
if ready, is dispatched. If OLD is not 
ready, the time-slice TQE is removed from 
the queue, and the Dispatcher searches for 
the next ready time-slice task as described 
above in "NEW Equals OLD." 
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NEW is not a Time-Slice Task and OLD is a 
Time-Slice Task ; The Dispatcher removes 
the time-slice TQE from the queue and dis- 
patches the task represented by NEW. 

NEW and OLD are not Time- Slice Tasks ; The 
Dispatcher searches the TCB queue for the 
highest priority ready task. If this is a 
time-slice task, the Dispatcher searches 
the time-slice group as described above in 
"NEW Equals OLD. " 

Dispatching the 7094 Emulator Program for 
the Model 85 

If the 7094 Emulator option is specified 
at system generation for a Model 85 , the 
Dispatcher uses the Diagnose instruction to 
enter or leave the emulator mode. Each 
time the Dispatcher receives control , it 
checks bit 3 of the TCBTRN field of the 
TCBs addressed by NEW or OLD or both to 
determine if either TCB is that of the 7094 
Emulator Program. If it is, the Dispatcher 
issues a Diagnose instruction to enter or 
leave the emulator mode. 

Handling Job Step Timing When a Task Switch 
is to Occur 

Job step timing is requested by a job 
step's Initiator via an STIMER macro 
instruction that specifies the TASK 
operand. The Dispatcher handles job step 
timing if a task switch is needed and the 
job step timing option was specified at 
system generation. 

If these conditions are met, the Dis- 
patcher suspends timing of the job step 
whose task is giving up control by branch- 
ing to the timer DEQ Routine (IEAQTD01) to 
dequeue the old task's TQE. It then 
restarts timing of the job step whose task 
is next to be dispatched by branching to 
the timer ENQ routine (IEAQTE00) to add the 
new task's TQE to the timer queue. 

Removing from the Timer Queue the TQE for 
the Job Step Associated with the Task that 
is Giving up Control ; The Dispatcher does 
the following to determine if job step tim- 
ing is being performed for the job step 
that is giving up control; 

o It tests the TCBPIB field of the TCB 
for the address of a PIB. If this 
field contains 0's, a system task is 
giving up control and therefore has no 
job timing associated with it. 



• If the TCBPIB field contains a PIB 
address, the Dispatcher tests the high- 
order bit in the job step timing status 
bits field of the PIB. If this bit is 
off, an initiator, a reader, or a writ- 
er is executing in the partition and 
also has no job step timing associated 
with it. 

• If the bit is on, the Initiator has 
requested job step timing for a problem 
program and a job step TQE is on the 
timer queue. The Dispatcher therefore 
examines the TQEFLGS field to determine 
the TQE type. If the TQE is a REAL 
type, it will not be removed from the 
timer queue because it represents a 
wait time limit interval. It was es- 
tablished as a wait time limit TQE and 
queued by the WAIT routine (IEAAWT), 
and it will be dequeued by the POST 
routine (IEAAPT) . 

If the TQE is a TASK type, the Dispatch- 
er branches to the timer second level 
interruption handler, to suspend job step 
timing for the old task. 



Placing on the Timer Queue the Job Step TQE 
for the Job Step Associated with the Task 
to be Dispatched ; The Dispatcher does the 
following to determine if job step timing 
is being performed for the job step that is 
about to be dispatched; 

o It tests the TCBPIB field of the TCB 
for the address of a PIB. If this 
field contains 0's, a system task is 
receiving control and therefore has no 
job step timing associated with it. 

• If the TCBPIB field contains a PIB 
address, the Dispatcher tests the high- 
order bit in the job step timing status 
bits field of the PIB. If this bit is 
off, a reader, a writer, or an initia- 
tor is receiving control and also has 
no job step timing associated with it. 

• If the bit is on, job step timing has 
been requested for the problem program 
in the partition via a STIMER macro 
instruction issued by the Initiator. 
The Dispatcher therefore branches to 
the timer ENQ routine (IEAQTE00) in the 
Timer Second-Level Interruption Handler 
to add the TQE to the timer queue and 
restart job step timing for this task 
that is about to be dispatched. 
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TASK SUPERVISION ROUTINES 



ATTACH (WITH SUBTASKING) (1EAQAT00) 
CHART BA 

ATTACH first determines if the request 
was made within a STAE user-exit routine. 
If so, ATTACH loads a return code of 4 into 
register 15 and issues an SVC 3 (EXIT) 
instruction to return control to the call- 
er. Otherwise, ATTACH examines the TCB 
address table to determine if there is an 
empty field. If no empty field is found, 
the caller is abnormally terminated because 
the limit on the number of subtasks estab- 
lished at system generation has been 
surpassed. 

If an empty slot in the TCB address 
table is found, ATTACH issues a GETMAIN 
macro instruction requesting the allocation 
of space from the system queue area for the 
subtask TCB. The address of the new TCB is 
placed in the TCB address table, and the 
location of the TCB table entry is indi- 
cated in the TCBID field of the new TCB. 
ATTACH initializes the TCBJMSS field with 
the address of the boundary box, and, if 
jobstep timing is in the system, ATTACH 
initializes the timer queue element. 

ATTACH then obtains main storage from 
the partition for a dummy program request 
block (PRB) , creates a gotten subtask area 
queue element for the PRB, chains the GQE 
to the boundary box of the new TCB, and 
places the PRB on the RB queue of the new 
TCB. ATTACH requests additional main 
storage for use as a save area by the sub- 
task. The address of the save area is 
stored in the TCBFSA field of the new task 
control block. 

If the ETXR operand has been specified 
in the ATTACH macro instruction and an 
interruption request block (IRB) already 
exists, indicating that the requested exit 
routine is already scheduled for execution, 
ATTACH acquires main storage for an inter- 
ruption queue element (IQE) to indicate 
that an additional request for the exit 
routine is pending. If an IRB does not 
exist for the desired exit routine, ATTACH 
obtains main storage for an IRB and IQE and 
branches to the CIRB (construct IRB) rou- 
tine to initialize and schedule the IRB. 

ATTACH determines in the following man- 
ner whether an IRB already exists: the 
ATTACH routine searches the subtask TCB 
queue belonging to the caller* s TCB, look- 
ing for a subtask TCB that indirectly 
points to the same end-of-task exit address 
as that specified in the caller's ATTACH 



macro instruction. A subtask 1 s exit- 
routine address is determined indirectly 
via the TCBIQE field of the subtask* s TCB. 
The TCBIQE field points to an interruption 
queue element (IQE), if one has been 
created for the subtask. If the TCBIQE 
field is 0, this subtask has no IQE, and 
thus no end-of-task routine has been 
requested for this subtask. If a subtask" s 
TCB IQE field is not 0, it points to an 
IQE, which points to an IRB, which points 
to an end-of-task exit routine for the sub- 
task. If the exit routine address in the 
subtask* s IRB is equal to the end-of-task 
exit routine address specified in the call- 
er* s ATTACH macro instruction, an IRB for 
the desired exit routine already exists. 

If ATTACH successfully obtains storage 
for the IQE, it initializes the fields of 
the IQE and increases the "use" count 
(RBUSE) of the IRB by one. This use count 
indicates the number of subtasks that use 
the same end-of-task exit routine. 

If neither an ECB address nor an ETXR 
address was specified in the ATTACH macro 
instruction, ATTACH schedules the system 
end-of-task (EOT) routine by constructing 
an IRB and IQE specifying the EOT routine. 
The system end-of-task routine, a subrou- 
tine of the EXIT routine, issues an SVC 62 
(DETACH) instruction to free the subtask 
and its TCB when processing is complete. 

The ATTACH routine initializes the newly 
created subtask TCB. If the ETXR operand 
was specified in the caller's ATTACH macro 
instruction or if the system EOT routine is 
scheduled, the address of the IQE is placed 
in the TCB (TCBIQE field) , and a flag is 
set to indicate that an end-of-task exit 
routine has been requested. 

If the ECB address has been specified, 
the ATTACH routine ensures the validity of 
the ECB address and places the ECB address 
in the TCBECB field of the new TCB. If the 
ECB address is invalid (does not specify a 
fullword boundary or violates storage pro- 
tection) , the ATTACH routine issues an 
ABEND macro instruction to abnormally ter- 
minate the caller. 

The ATTACH routine next determines the 
limit and dispatching priorities from input 
parameters, and stores the priorities in 
the new TCB. The limit priority of the 
subtask is set according to input parame- 
ters but not higher than the limit priority 
of the caller's task. The dispatching 
priority of the subtask is similarly set 
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according to the input parameter but not 
higher than its own limit priority. If the 
priority parameters have not been specified 
by the caller, the ATTACH routine sets the 
subtask priorities to that of the calling 
task. 

If the time-slicing feature is included 
in the system, the ATTACH routine tests 
whether the new TCB represents a time- 
sliced task (is within the range of dis- 
patching priorities recorded in the TSCE) . 
If the dispatching priority is not within 
range, the new task is not a member of the 
time-sliced group and further time-slice 
processing is bypassed. If the new task is 
a member of the time-sliced group, ATTACH 
sets the time-slice bit (TCBFTS) in the 
TCB. If the new TCB represents the only 
task in the group, its address is placed in 
the FIRST, LAST, and NEXT fields of the 
TSCE. ATTACH then queues the TCB on the 
dispatching and subtask TCB queues. ATTACH 
queues the new TCB to the subtask task 
queue by adjusting the TCBOTC, TCBNTC, and 
TCBLTC fields of the new TCB. 

ATTACH determines whether the current 
program or the subtask will receive control 
next from the dispatcher. The ATTACH rou- 
tine examines the dispatching priorities of 
the two tasks and stores the address of the 
TCB for higher priority task in a TCB 
pointer (IEATCBP) to be later tested by the 
Dispatcher when it receives control during 
the exiting procedure. 

ATTACH places the address of an SVC 6 
(LINK) instruction in the resume PSW in the 
dummy PRB. This will cause the loading and 
execution of the requested program when the 
SVC 6 is executed. 

The ATTACH routine prepares for exiting 
by storing the caller* s registers in the 
subtask' s TCB. ATTACH then issues an SVC 3 
(EXIT) instruction. 



CHAP calculates the new dispatching 
priority for the TCB and queues the TCB in 
a new location on the dispatching and Time- 
slice queues. 

Placing the Changed TCB on the Dispatching 
and Time-Slice Queues 

CHAP performs several tests to determine 
the extent of the priority change that can 
be permitted. The first test checks wheth- 
er the result of the change in dispatching 
priority is or negative. The dispatching 
priority of the changed TCB is set to 
whenever the calculated priority is less 
than or equal to 0. 

If the calculated priority is greater 
than and less than or equal to the limit 
priority of the caller, CHAP stores the 
calculated dispatching priority in the 
TCBDSP field of the changed TCB. If the 
limit priority of the changed TCB is less 
than its new dispatching priority, CHAP 
sets the limit priority equal to the new 
dispatching priority. 

If the calculated dispatching priority 
is greater than 255 or greater than the 
limit priority of the caller, CHAP propa- 
gates the limit priority of the caller to 
the limit (TCBFTLMP) and dispatching 
(TCBDSP) fields of the TCB to be changed. 

If the time-slicing feature is included 
in the system, CHAP tests whether the new 
dispatching priority falls within the 
priority range represented in the TSCE. If 
the task is now a time-slice task, CHAP 
sets the time-slice bit (TCBFTS) in the 
TCB. The CHAP routine tests the NEXT field 
in the TSCE. If the field contains 0, the 
specified task is the only member of the 
time-slice group, and the CHAP routine 
places its TCB address in the FIRST, NEXT, 
and LAST fields in the TSCE. If the NEXT 
field in the TSCE is not 0, the FIRST or 
LAST field is adjusted if necessary (NEXT 
is not changed) . 



CHAP (ONLY WITH SUBTASKING) (IEAQCH00) 
CHART BC 

The CHAP routine receives control as a 
type 2 SVC routine from the SVC SLIH or 
serves as a subroutine via a branch entry 
from a supervisor routine. If the input 
parameter is zero, then the caller wants to 
change the dispatching priority of his own 
task. Otherwise, CHAP tests the address of 
the TCB passed by the caller for validity. 
(Validity testing is bypassed if the caller 
is a system task.) 

If time-slicing was selected during sys- 
tem generation, and the task is a member of 
the time-slice group, CHAP dequeues the TCB 
from the Time-slice queue. 



DETACH (ONLY WITH SUBTASKING) (IEAGED02) 
CHART BB 

DETACH first tests the validity of the 
subtask TCB address. If any validity check 
fails, DETACH loads an error code and 
issues an ABEND macro instruction to 
abnormally terminate the caller's task. 

If the input address is valid, DETACH 
determines if the caller belongs to the 
parent task of the specified subtask. If 
the subtask TCB address is not found on the 
caller's subtask queue, DETACH loads the 
same error code as that for an invalid TCB 
address, and issues an ABEND macro instruc- 
tion to abnormally terminate the caller's 
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task. If the specified subtask TCB address 
is found in the subtask queue, processing 
continues . 

The DETACH routine next determines if 
the subtask is complete (that is f whether 
the task has been terminated by either the 
EOT or ABEND routine) by testing the "com- 
pletion" indicator TCBNDSP3 in the TCBFLGS 
field of the subtask TCB. This indicator 
bit is set by the EOT routine or by the 
ABEND routine. If the subtask has been 
terminated, the DETACH routines 

• Removes the subtask TCB from the sub- 
task queue of the caller - s TCB. This 
is necessary since the ABEND or EOT 
routines will try, when a later request 
to terminate the caller* s task is 
issued, to release resources belonging 
to its subtasks. 

• Frees the main-storage areas belonging 
to the subtask that were not freed dur- 
ing the termination processing. These 
areas include the main storage occupied 
by the subtask TCB and the optional 

7 2- byte problem- program register save 
area. (The address of the problem- 
program save area is contained in the 
TCBFSA field Of its TCB.) 

• Returns control to the caller. 

If DETACH discovers that the subtask was 
not normally or abnormally terminated, it 
initiates abnormal termination of the sub- 
task, unless it is already being ter- 
minated. (The TCBNDSP3 flag, if set, indi- 
cates that the subtask has been normally or 
abnormally terminated.) If the subtask is 
not already being terminated, DETACH loads 
an error code and branches to ABTERM to 
schedule the abnormal termination. The 
DETACH routine cannot invoke the ABEND rou- 
tine directly, since the caller's task is 
not to be terminated. The ABEND routine, 
when invoked directly, can terminate only 
the current or calling task. 

DETACH next indicates that the subtask 
has been abnormally terminated and saves 
(in its SVRB) the address of the subtask' s 
event control block (ECB), if one was spe- 
cified when the subtask was attached. (The 
ECB address is contained in the subtask f s 
TCBECB field.) DETACH then obtains four 
bytes of space for a new ECB in which the 
ABEND routine can post the subtask" s ter- 
mination. (The actual posting is performed 
for the EOT routine, which is invoked by 
the ABEND routine when the termination is 
complete.) DETACH initializes the new ECB 
to and places its address in the subtask 
TCB. DETACH also clears the IQE pointer 
(TCBIQE) in the subtask TCB, so that an 
end-of-task exit routine (if one exists) 
will not be scheduled by the EOT routine 



when the subtask is terminated. (The 
TCBIQE field contains an indirect pointer 
to an end-of-task exit routine if the call- 
er specified the ETXR operand when it 
attached the subtask.) 

DETACH issues a WAIT macro instruction 
to wait until the ABEND routine completes 
the abnormal termination of the subtask. 
The abnormal termination of the subtask is 
signaled by the posting of the new ECB by 
the EOT routine. DETACH then frees the 
storage occupied by the special ECB it had 
created and tests whether the subtask has 
its own ECB. (DETACH saved the subtask' s 
ECB address — if it had an ECB — in the 
current SVRB.) 

If the subtask does not have an ECB, 
DETACH cannot inform the caller of the sub- 
task termination when control is returned 
to the caller. If, however, the subtask 
has an ECB, DETACH uses the EOT validity 
check routine to ensure that the ECB con- 
tains valid information and has not been 
altered by a user program. This check is 
needed since the POST routine will not make 
the check when it posts the ECB. If the 
user program has altered the ECB contents, 
and this alteration remains undetected, 
processing of the ECB by the POST routine 
causes a program check. 

If the ECB does not contain a valid RB 
address, DETACH loads an error code and 
invokes the ABEND routine to abnormally 
terminate the caller's task. If the ECB is 
valid, DETACH posts the ECB to indicate to 
the caller that the subtask has been 
abnormally terminated. Then, via the EXIT 
routine and the Dispatcher, it returns con- 
trol to the caller. 



EXTRACT (WITHOUT SUBTASKING) (IEAAXROO) 
CHART BD 

The EXTRACT routine is entered from 
interruption supervision when the EXTRACT 
macro instruction is issued. Upon entry, 
EXTRACT sets all fields in the list area 
specified by the user to zero, except for 
the task input/output table (TIOT) address 
field. If the macro instruction parameters 
specified TIOT or ALL, the address in the 
TCB of the TIOT is inserted into its re- 
spective field in the user's list. EXTRACT 
issues an SVC 3 (EXIT) instruction on 
completion. 



EXTRACT (WITH SUBTASKING) (IEABXROO) 
CHART BE 

The EXTRACT SVC routine permits the 
macro- issuing or calling program to obtain 
from a specified TCB or a subsidiary con- 
trol block the information contained in 
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seven of its fields. The specified TCB 
must be either the TCB of the issuing pro- 
gram or of one of its subtasks — tasks 
attached by the issuing program. The 
information may be extracted from any com- 
bination of the seven fields or from all of 
the seven fields. When extracted, the 
information is placed in a user-specified 
list. The fields from which information 
may be extracted and the information con- 
tained in each field are described in the 
publication Supervisor Services and Macro 
Instructions . 

Besides extracting information from a 
specified TCB or a subsidiary control 
block, EXTRACT performs several checks to 
determine if the input parameters passed by 
a problem program are valid. This validity 
checking prevents the extraction of mean- 
ingless data, or the later occurrence of a 
program interruption whose cause may be 
difficult to interpret. Invalid parameters 
cause the routine to generate an error code 
and cause an abnormal termination of the 
task. 

EXTRACT first tests type of entry and 
sets indicators accordingly. It also 
determines whether information is to be 
extracted from the current TCB (caller's 
TCB) or from the TCB of one of its sub- 
tasks. If information is to be extracted 
from the current TCB, its address is set 
up, and the following test for a subtask is 
bypassed. 

If the specified TCB represents a sub- 
task of the callers TCB, EXTRACT prevents 
a possible program interruption by forcing 
the TCB pointer (second word of the input 
parameter list) to a fullword boundary. 
The routine then scans the subtask queue of 
the caller's TCB to determine if the speci- 
fied TCB address represents a subtask of 
the caller's TCB. If no match of TCB 
addresses can be obtained, the caller must 
have incorrectly specified the TCB address. 
Since useful information cannot be obtained 
from the specified TCB, EXTRACT issues an 
SVC 13 (ABEND) instruction specifying error 
code 328. 

EXTRACT next passes control to the 
supervisor's Validity Check routine to per- 
form the needed checking. The Validity 
Check routine performs three tests to 
determine the correctness of the extract 
list address. The extract list is the 
user-specified table in which the EXTRACT 
routine places the requested TCB informa- 
tion. One test determines if the list 
address lies on a fullword boundary, as 
required. Another test checks whether the 
list address lies within the boundaries of 
main storage. The remaining test deter- 
mines if the list address specifies a 
storage area whose storage protection key 



matches the protection key in the caller's 
TCB. If any of these tests indicates that 
the calling program has incorrectly speci- 
fied the extract list address, EXTRACT 
issues an SVC 13 (ABEND) instruction. 

If parameters have been specified 
correctly, as indicated by the several 
validity checks, or if validity checks have 
been bypassed, normal processing of the 
requested TCB information continues. 
EXTRACT tests each bit of an extraction 
byte, a part of the parameter list, which 
represents the FIELDS parameter of the 
EXTRACT macro instruction. For each bit 
that is set, EXTRACT places the appropriate 
information from the specified TCB into the 
user list. If a bit is not set, the rou- 
tine makes no entry in the list for the 
field represented by that bit. The result- 
ing list is of variable length and packed 
in a standard order. (See Supervisor Ser- 
vices and Macro Instructions .) 

Note that some of the fields that may be 
requested are not contained in the speci- 
fied TCB. These fields are those requested 
by the following parameters: GRS (general 
register save area), FRS (floating-point 
register save area) , the AETXR (end-of-task 
exit routine), and COMM (CSCB communica- 
tions list) . For the first two parameters 
the returned value is the address of the 
appropriate save area. The value is calcu- 
lated from the address of the specified 
TCB. The returned value points to the save 
areas which are in the TCB. For the third 
parameter, AETXR, the returned value 
(address of the exit routine) is obtained 
indirectly from the TCB. The TCBIQE field 
in the TCB points indirectly to the end-of- 
task exit routine, via pointers in an 
interruption queue element (IQE) and an 
interruption request block (IRB) . The 
address of the end-of-task exit routine is 
obtained from the IRB. For the fourth pa- 
rameter, COMM, the returned value (address 
of the communications list) is also 
obtained indirectly. The TCB points to the 
JFCB, which points to the CSCB in which the 
communications list resides. When EXTRACT 
has placed all the requested information in 
the user-specified list, it issues an SVC 3 
(EXIT) instruction. 



WAIT (IEAAWTOO) CHART BF 

WAIT tests the wait count specified as 
an operand of the WAIT macro instruction. 
If the wait count is or negative, the 
WAIT routine ignores the request and 
branches to the type 1 Exit routine to 
return control to the caller. 

If a wait count greater than has been 
specified, WAIT sets the system mask in the 
SVC old PSW to l's. Thus, when the SVC old 
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PSW is loaded to pass control back to the 
caller, the caller will be enabled for I/O 
and external interruptions. (This action 
prevents supervisor routines that operate 
disabled and use the WAIT macro from plac- 
ing the task into a disabled wait state.) 



WAIT then tests register 1. If register 
1 has the address of a single ECB, WAIT 
stores the address of the ECB in location 
WTSIMLST and flags the ECB address to 
appear as the last address entry in a pa- 
rameter list. WAIT then loads the address 
of location WTSIMLST into register 1, 
thereby simulating a list of ECBs contain- 
ing only one entry. 

If the validity check option is in the 
system and the caller is a user program, 
WAIT branches to the validity check subrou- 
tine to test each ECB address. If an error 
is indicated, WAIT determines if the com- 
munications ECB was specified. If so, 
normal WAIT processing continues. If the 
ECB specified is not the communications 
ECB, the task is abnormally terminated. If 
the caller is a system routine, indicated 
by a protection key, WAIT does not verify 
the ECB addresses passed by the caller. 

After checking the validity (optional) 
of the ECBs, the wait count is saved and a 
register is initialized with the address of 
the ECB from the macro instruction parame- 
ter list. An ECB counter is incremented as 
each ECB is addressed. 

WAIT tests the wait bit in the ECB. If 
the wait bit is on, an error condition 
exists, and WAIT then branches to the 
ABTERM routine to schedule abnormal ter- 
mination. If the wait bit is off, the com- 
pletion bit is tested. If the completion 
bit is off, indicating that POST has not 
posted the event as being completed, the 
wait bit is turned on, and the address of 
the current RB is placed in the ECB. 

If the completion bit is on, the wait 
count is decremented by 1 and the remainder 
is tested for 0. 

1. If the wait count is 0, and if the 
number of events being waited on is 
less than the number of specified ECBs 
(as indicated by the "search" flag in 
the caller's RB) , WAIT clears the wait 
bit in each ECB that has not been 
posted. The purpose of clearing the 
wait bit in each ECB that has not been 
posted is to prevent POST from later 
mistaking an uncleared wait in a ECB 
for a new wait request. Since the 
wait count is 0, all events being 
waited on have occurred, and therefore 
the caller must not wait. WAIT stores 
the wait count in the caller f s RB and 



returns control by branching to the 
type 1 Exit routine. 

2. If the wait count is not 0, then 

another ECB is addressed and the tests 
described in the preceding paragraphs 
are repeated. If the ECB tested was 
the last or only ECB, WAIT continues. 

If all the ECBs have been tested and the 
wait count has not become 0, the total num- 
ber of ECBs specified is compared to the 
original wait count. If the number of ECBs 
specified is less than the count, the count 
cannot be satisfied and the task is abnorm- 
ally terminated. 

If the wait count is less than the num- 
ber of ECBs, a bit (the "search" flag) is 
turned on in the RB to indicate to POST 
that a multiple-event wait has been issued. 
(In a multiple- event wait, the number of 
ECBs is greater than the wait count.) This 
means that the caller wishes to wait on 
fewer events than specified. (For example, 
the caller may wait on the completion of 
any one of three possible I/O operations.) 
When an event being waited on takes place 
(the single I/O operation) , the wait bit 
remaining set in each of the two ECBs not 
yet posted is now misleading. These bits 
may cause later incorrect processing by 
POST. If the search bit is set, POST 
clears the wait and search bits in each of 
the ECBs not yet posted. 

When the WAIT routine has processed all 
ECBs in the parameter list, it inserts the 
final wait count in the wait count field 
(XRBWT) of the caller's RB. Since the wait 
count is greater than 0, the caller is now 
in the wait condition, or "waiting", and 
cannot be dispatched. In this case, the 
WAIT routine sets NEW to to force a task 
switch and returns by branching to the 
Type-1 Exit routine. 



POST (IEAAPT00) CHART BG 

There are four branch entry points to POST: 

• IEAAPT01 is used by supervisor 
routines. 

• IEA0PT01 is used exclusively by the I/O 
supervisor. 

• IEA0PT01+4 and IEAAPT01+4 are used by 
the I/O supervisor and task management 
supervisor, respectively, when these 
routines do not need to check the vali- 
dity of user-specified event control 
blocks. 

An additional entry point, IGC002, is 
entered when the caller issues an SVC 2 or 
a POST macro instruction. 
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If validity checking has not been 
bypassed, POST checks the validity of the 
ECB address passed by the caller. In addi- 
tion, if the wait bit is set in the speci- 
fied ECB, POST checks the validity of the 
RB address contained in the ECB. 

The next step is checking the completion 
bit in the ECB. If the completion bit is 
set, indicating that the event to be posted 
has already been posted, there is no need 
for further processing. The wait flag is 
cleared and control is returned to the 
caller via the Type 1 Exit routine. If the 
completion bit is not set and the wait flag 
is not set, POST stores a completion code 
in the ECB, overlaying the RB address 
field. (The completion code was specified 
by the caller of POST as an operand of the 
POST macro instruction.) POST then sets 
the completion bits, clears the wait bit in 
the ECB, and returns control via the Type 1 
SVC Exit routine. These bits indicate to 
WAIT as well as to POST and the caller that 
the specified event has occurred. 

If the wait flag is set, POST next 
determines whether to decrease the wait 
count stored in the waiting program's RB. 
The wait count indicates the number of 
specified events that must occur before the 
waiting program can resume execution. The 
wait count is tested by POST: 

o If the wait count is 0, POST stores the 
completion code in the ECB, adjusts the 
completion and wait flags, and returns 
control to the caller via the Type 1 
SVC Exit routine. (This can occur in 
the special case in which the waiting 
program is being abnormally terminated 
due to an event asynchronous to the 
waiting program. The ABTERM routine 
resets to the wait count in the top 
RB on the RB queue.) 

• If the wait count is not 0, POST sub- 
tracts 1 from the wait count (XRBWT) in 
the waiting program 1 s RB and determines 
whether the wait count is now 0. 

1. If the reduced wait count is not 0, 
all events awaited by the program 
have not yet occurred. The comple- 
tion code is stored in the ECB, the 
completion and wait flags are 
adjusted, and control is returned 
via the Type 1 SVC Exit routine. 

2. If the reduced wait count is 0, 
processing continues. 

POST next determines if the specified 
ECB points to the top RB on the queue. If 
not, processing continues with the test for 
the multiple- event wait (below) . If this 
top RB has a REAL job-step TQE (this is for 
a 30-minute wait) on the timer queue, the 



timer dequeue subroutine in the timer SLIH 
is used to remove it from the queue, the 
TQEVAL is restored, and the TQE is again 
indicated as TASK type. This allows the 
Dispatcher to again calculate the CPU time 
used by this job step. 

Because the program is no longer await- 
ing the completion of events, POST must 
next determine from the "subject" TCB (the 
TCB pointed to by the top RB) if the task 
is dispatchable and, if so, which task is 
to be dispatched next. If the task is not 
dispatchable, processing continues with the 
test for the multiple- event wait (below). 
If the task is dispatchable and NEW (the 
pointer in the Dispatcher to the task next 
to be dispatched) is , or if NEW is not 
but the "subject" TCB has a higher dis- 
patching priority than the task pointed to 
by NEW, the address of the "subject" TCB is 
placed in NEW to indicate to the Dispatcher 
that a task switch is necessary. If the 
two tasks have the same dispatching priori- 
ty, POST puts the address of the "subject" 
TCB in NEW only if it is placed higher on 
the TCB queue. If it is placed lower on 
the queue, NEW remains unchanged. 

The multiple- event wait allows the user 
to await the completion of more than one 
event. If only one ECB was specified in 
the WAIT macro instruction, POST stores the 
completion code in the ECB, sets the com- 
pletion flag, clears the wait flag and 
passes control to the Type 1 SVC Exit rou- 
tine. If more than one ECB was specified, 
POST ensures that the wait flag in all the 
ECBs specified by the WAIT macro instruc- 
tion are set to zero. POST then stores the 
completion code, adjusts the completion and 
wait flags, and branches to the Type 1 SVC 
Exit routine. 



ENQ (IEAGENQ1) CHART BH 

The ENQ macro instruction is issued as a 
conditional or unconditional request. The 
differences in ENQ processing when the 
f RET= f parameter is specified as 'TEST', 
■USE", or "HAVE 1 are discussed separately 
under "Conditional Requests." 

Unconditional Request ; If the "set must 
complete" option was specified by a user 
program, the task is abnormally terminated 
(an SVC 13 is issued) and a return code is 
placed in register 1. ENQ then verifies 
parameters passed by the caller if the 
caller is a user routine. This protects 
the queues by preventing a possible program 
interruption during queue manipulation. If 
the caller is a system routine (the RB old 
PSW has a protection key) , the parameters 
are assumed to be correct. If the caller 
is a user routine and an addressing error 
is found, ENQ sets an error code and issues 
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an SVC 13 (ABEND) to abnormally terminate 
the program. If the rname length is 0, the 
code is set to 238 before the task is 
abnormally terminated. If the caller's 
protection key is not and the SMC= 
operand was specified, the completion code 
is 338, If the parameter list is not on a 
fullword boundary , the completion code is 
438. (See Figure 33 for a description of 
ENQ return codes . ) 

ENQ then creates, initializes, and 
queues the necessary control blocks for the 
resource requests of the task that issued 
the ENQ macro instruction. (See Section 5 
for a description of the control blocks.) 
Each resource request will be represented 
by three control blocks. The major queue 
control blocks (QCBs) will be chained to 
the last major QCB on the queue or, if no 
others exist, to IEAQCB01. The minor QCBs 
will be chained to their associated major 
QCB and the queue elements (QELs) to their 
associated minor QCB. Main storage 
required for the control blocks is acquired 
in the system queue area (subpool 255) via 
an SVC 10 (GETMAIN). ENQ searches the 
queues, starting with the major QCB queue, 
and builds control blocks and performs 
additional processing according to the 
existing control blocks that represent the 
requested resource: 

• If there is no existing major QCB for 
the qname specified, or if there is a 
major but no minor QCB for this 
resource, control of the resource has 
not been previously requested. ENQ 
processes the necessary control blocks 
and increments the enqueue count 
(TCBLMP) in the requester's TCB by one. 
If the rname length specified in the 
parameter list element is incorrect, an 
error code is set in register 1 and the 
task is abnormally terminated. 

• If a major and minor QCB already exist 
for this resource, ENQ then tests for a 
duplicate request by the same task. 



| Return Codej 



Meaning 



8 JThe caller's task is already 
(enqueued. (This is an error 
| condition.) 

,. + ) 

4 | The resource is in use, and 
| the caller's request has not 
| been enqueued. 

i. + ^ 

I The resource is available, or 
j the caller's request has been 
I enqueued . 

Figure 33. Return Codes for the ENQ 
Routine 



This occurs when the requesting program 
issued a second ENQ macro instruction 
for the same resource without an inter- 
vening DEQ macro instruction, and is 
indicated by the existence of a QEL 
containing the requester's TCB address. 
If a QEL is found, ENQ places an error 
code in register 1 and issues SVC 13 
(ABEND) to abnormally terminate the 
program. If a duplicate QEL is not 
found, ENQ determines the availability 
of the resource by testing the type of 
request made and the types of previous 
QELs on the queue. If the request is 
for shared control, and the previous 
requests were for shared control, the 
requester can get immediate control of 
the resource. If a QEL representing an 
exclusive request is already queued for 
the resource, the resource is under the 
control of another task, and the RB 
wait count in the SVRB is incremented 
by one. In either case, ENQ creates a 
QEL and increments the enqueue count in 
the TCB by 1. This count, which is 
decremented by the DEQ service routine 
when the previous exclusive requesters 
have completed use of the resource and 
issued a DEQ, causes the requesting 
task to wait in ENQ but does not effect 
the dispatchability of the task as a 
whole. Asynchronous routines, repre- 
sented by IRBs on the TCB's request 
block queue, can still operate under 
the task's control. 



After all the resources requested in the 
ENQ macro instruction have been processed, 
ENQ determines which routine is to gain 
control and branches to it. The operations 
performed by ENQ depend on the availability 
of the resources and on whether "set must 
complete" was specified. 

• If the resources are available (the RB 
wait count in the SVRB equals 0), ENQ 
determines if "set must complete" was 
specified. If it was not specified, 
ENQ issues an SVC 3 which will return 
control to the caller via EXIT and the 
Dispatcher. If it was specified, ENQ 
places the caller's task in "STEP or 
SYSTEM must complete" status. For a 
system must complete request, nondispa- 
tchability flags are set in all the 
TCBs in the system except the communi- 
cations task, the master scheduler, the 
system error task, the transient area 
loading task, and the caller. This 
ensures that the caller will gain imme- 
diate control and retain control until 
it issues a DEQ macro instruction for 
these resources, or is abnormally ter- 
minated. For step "must complete," all 
tasks in the job step except for the 
caller are set nondispatchable. ENQ 
then returns control to the caller via 
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EXIT and the Dispatcher by issuing an 
SVC 3. 



If the resources are not available (the 
RB wait count in the SVRB is not 0) , 
ENQ prepares for the caller's future 
restart. An address in the ENQ routine 
is placed in the SVRB old PSW so that 
when the resources become available , 
ENQ will test for and, if specified, 
perform the "set must complete" func- 
tion, and issue the SVC 3 which will 
return control to the caller. The 
caller remains in a wait state until 
the resources requested have been made 
available. ENQ then sets the TCB 
pointer (IEATCBP in the CVT) to and 
branches to the Dispatcher for a task 
switch. The next highest priority task 
will receive control. 



Conditional Request ; If "TEST", "USE", or 
"HAVE" was specified in the •RET= f parame- 
ter in the ENQ macro instruction, request 
for the resource is conditional. Validity 
checking function is performed, and the 
task is abnormally terminated if an error 
condition is found. Whether the resources 
are enqueued to that task depends on the 
conditions below: 

• If , RET=TEST" was specified, ENQ tests 
the status of the resources and returns 
control to the caller through the EXIT 
routine and the Dispatcher via an SVC 
3. No control blocks are created or 
enqueued. Register 15 contains a 
return code of if the return codes of 
all requested resources are 0, or will 
contain the address of a list of return 
codes in main storage. (See Figure 33 
for a description of return codes and 
their meanings • ) 

• If 'RET=USE' was specified, ENQ deter- 
mines whether the resources are avail- 
able and assigns control of the 
resources only if all are immediately 
available. If they are available, ENQ 
performs the same operations as for an 
unconditional request and places a zero 
in register 15. If they are not all 
available, processing is as "RET=TEST" 
above. 

• If •RET=HAVE i was specified, ENQ deter- 
mines if this is a duplicate request. 
If a previous request has not been made 
by this task for the same resources, 
ENQ performs as for an unconditional 
request and passes a return code or the 
address of a list of return codes in 
register 15. If a previous request has 
been made, ENQ loads a return code of 8 
and returns control to the caller via 
an SVC 3. 



DEQ (IEAGENQ1) CHART BJ 

The DEQ macro instruction is normally 
used for an unconditional request for 
release of resources. The differences in 
DEQ processing when " RET=HAVE f is specified 
are discussed separately under "Conditional 
Requests." 

Unconditional Request ; The first function 
of the DEQ routine is to check the validity 
of input parameters. If the issuing pro- 
gram is a supervisor routine (the protec- 
tion key in the RB old PSW equals 0) , the 
parameters are assumed to be correct. If 
it is a user program and an addressing 
error is found, or the rname length speci- 
fied is zero, an SVC 13 (ABEND) is issued 
to abnormally terminate the task. (See 
Figure 34 for other DEQ error conditions.) 

If this is a valid request for release 
of resources, the queues are searched to 
find the current QEL associated with the 
specified major and minor QCBs. To be a 
valid request, a major and minor QCB and a 
QEL must exist for the resource specified 
in the DEQ macro instruction, and the task 
must have been given control of the 
resource: 

• If any of the control blocks (major 
QCB, minor QCB, and QEL) associated 
with the DEQ request are not found, the 
request has not been enqueued and the 
caller is abnormally terminated (an SVC 
13 is issued) with an error code in 
register 1. 

• If the QEL is not on the top of the 
queue (the TCB address in the current 
QEL is not the same as the current TCB 
address) , and it represents an exclu- 
sive request or there are previous 
exclusive requests on the queue, the 
DEQ was issued by a task that did not 
have control of the resource. An error 
code is set in register 1, and an SVC 
13 is issued. 

If a valid DEQ has been issued (the QEL 
is at the head of the queue or it is a 
shared request with no previous exclusive 
requests) , DEQ then decrements the enqueue 
count in the TCB (TCBCT) , dequeues the QEL, 
and releases the main storage occupied by 
the QEL via an SVC 10 (FREEMAIN). DEQ then 
tests for outstanding requests for the same 
resource. 

• If there are more QELs on the queue, 
DEQ determines if the next waiting 
requester, represented by the new top 
QEL, should be readied. The decision 
is based on the type of new top QEL, 
shared or exclusive, and on the type of 
dequeued QEL. The conditions and 
results for the three possible situa- 
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h 



Condition 



RET Operand of 
DEQ Macro 
Instruction Is: 



Resultant Processing 



H 



Resource names are not found in the 
QCB queues, or a QEL containing the 
caller's TCB address is not found. 



HAVE 



(1) Sets up return code of 8, in- 
dicating that the resource is not 
enqueued, and after processing 
other parameter- list elements, 
returns control to the caller, via 
the Exit routine and the Dispatcher 



omitted 
or NONE 



(2) Sets up an error code of 130 
and obtains supervisor linkage to 
the ABEND routine to abnormally 
terminate the caller's task 



h 



H 



QEL containing caller's TCB address 
is found, but is not at the logical 
top of the QEL queue, nor is it one 
of a "shared" group of QELs at the 
logical top of the queue. 



HAVE 



Same as (1) but return code is 4, 
indicating that the caller's task 
does not have access to the 
resource. 



H 



h 



omitted 
or NONE 



Same as (2) except that the error 
code is 230. 



RMC= operand is specified but 
user's protection key is not 0. 



Same as (2) except that the error 
code is 330. 



Figure 34. Error Conditions when Use of a Resource is Signaled Complete 



tions are described in Figure 35. DEQ 
then determines if a readied requester 
should be dispatched. If DEQ has just 
reduced the wait count to 0, the 
resources are now available. If there 
are no higher priority tasks ready to 
be dispatched, DEQ indicates a task 
switch by placing the requesting task's 
TCB address in the NEW TCB pointer 
(IEATCBP) in the Dispatcher. If a 
higher priority task is to be dis- 
patched, its address in NEW is left 
undisturbed. (It is also left undis- 
turbed if both the dequeued QEL and new 
top QEL represent shared requests.) 

• If there are no more QELs on the queue, 
there are no further requests for the 
resource. The minor QCB is therefore 
dequeued and the main storage space it 
occupies is released via an SVC 10 
(FREEMAIN) . In the same way, if there 
are no more minor QCBs on the queue, 
the major QCB is dequeued and its space 
released. 

When all the parameter list elements 
representing resource requests to be 
dequeued have been processed, DEQ deter- 
mines if it must perform the "reset must 
complete" functions. If "reset must com- 
plete" has been specified for system, the 
nondispatchability flags previously set in 
each TCB in the system (except the communi- 
cations task, the transient area loading 
task, the system error task, and the master 
scheduler) are cleared so that these tasks 



may be restarted. If "reset must complete" 
is specified for a step, the nondispatcha- 
bility flags previously set in other TCBs 
in the partition are cleared. DEQ also 
puts the TCB address of the highest priori- 
ty ready task now dispatchable in the NEW 
TCB pointer. If "reset must complete" is 
requested by a user routine, the task is 
abnormally terminated with an error code of 
330 in register 1. 

DEQ returns control to the caller or a 
readied requester via the EXIT routine and 
the Dispatcher (an SVC 3 is issued) . The 
EXIT routine dequeues the SVRB from its RB 
queue and frees the space that the SVRB 
occupies. The Dispatcher determines wheth- 
er the caller or a readied requester is to 
get control, according to the TCB address 
in the NEW TCB pointer (IEATCBP). 

Conditional Request : If the issuing task 
specified 'RET=HAVE', a conditional request 
for release of resources has been made. 
Normal DEQ functions are performed only if 
there is a major QCB, a minor QCB, and a 
QEL for the resource, and if the task has 
control of the resource. The task has con- 
trol of a resource if the associated QEL is 
at the top of the queue or represents a 
shared request with no previous exclusive 
requests on the queue. If the conditions 
are not met, no dequeuing is performed. In 
either case, if no error conditions are 
found, a return code is set in register 15, 
and an SVC 3 is issued to return control to 
the caller or to a readied requester via 



86 



Conditions 



H- 



| Status of QEL Queue 



Resultant Processing 



Condition A 
dequeued QEL 
new top QEL 



"shared" QEL 
" shared" QEL 



Routine does not reduce 
wait count in requester's 
RB. (Requester already 
has access to the resource,) 



■H 



Condition B 
dequeued QEL 
new top QEL 



QEL of either type 
" exclusive" QEL 



Routine reduces wait count 
in requester's RB and if 
new wait count is zero, it 
invokes the Task Switching 
routine to test whether the 
requester may be dispatched 
instead of the caller. 



Condition C 



dequeued QEL 
new top QEL 



+ 



•exclusive" QEL 
•shared" QEL 



Routine reduces wait count 
in requester's RB and if 
new wait count is zero, it 
invokes the Task Switching 
routine. Since new top QEL 
is the first QEL of a 
"shared" group, the routine 
repeats this procedure for 
the other QELs of the 
group. 



Figure 35. Determining if the Next Waiting Requester Should be Readied 



the EXIT routine and the Dispatcher. (See 
Figure 34 for a further description of pro- 
cessing when 'RET=HAVE'.) If an error con- 
dition is found, an error code is placed in 
register 1 and an SVC 13 (ABEND) is issued 
to abnormally terminate the task. 



beginning of the extended save area of the 
SVRB, which was constructed when the SVC 14 
was issued. The address of the PIE and the 
program mask (from the RB) are placed in 
the TCB field TCBPIE. The PIE is initial- 
ized to 0. 



SPIE (IEAAPX00) CHART BK 

SPIE first determines if a PIE must be 
created for this task. If a PIE already 
exists, this task has previously issued a 
SPIE macro instruction which it wishes to 
override. Only one PIE is created for a 
given task, and it is addressed by TCB 
field TCBPIE. (There may be several pro- 
gram interruption control areas (PICA) , one 
for each issuance of the SPIE macro 
instruction, but only the last specified 
PICA is active.) 

If a PIE does not exist for this task 
(the pointer to the PIE in TCBPIE equals 
0), the SPIE routine builds a PIE at the 



After the PIE has been located or 
created, SPIE saves the address of the pre- 
vious PICA, which it obtains from the PIE. 
The field is if this is the first 
issuance of the SPIE macro instruction for 
this task. The address of the new PICA, 
received as input in register 1, is then 
placed in the PIE. This will be if no 
user program interruption handling routine 
is specified. 

SPIE then determines the program mask to 
be placed in the caller's resume PSW by 
testing register 1 for 0. The program mask 
will be used by the program FLIH (first 
level interruption handler) to determine 
whether to give control to a user error 
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handling routine or to abnormally terminate 
the program. 

• If register 1 contains a new PICA 
address r SPIE moves the program mask 
from the new PICA to the resume PSW 
field of the RB, where the SVC old PSW 
is stored. This ensures that the user 
exit routine will be entered if one of 
the specified types of program inter- 
ruptions occurs. 

• If register 1 contains 0, the user does 
not wish to handle program interrup- 
tions and is canceling a previously 
issued SPIE macro instruction. The 
initial program mask (before the first 
SPIE was issued) is restored to the 
resume PSW field of the RB from the TCB 
field TCBPIE. Thus when a program 
interruption occurs and the program 
mask is tested, the program FLIH recog- 
nizes that a user program interruption 
handling routine has not been requested 
and the task is abnormally terminated. 

The SPIE routine then places the address 
of the previous PICA into register 1, and 
sets a return code of in register 15. 
Interruptions are enabled , and an SVC 3 is 
issued to pass control to EXIT. 



STAE (IEAASTOO) CHART BL 

The STAE service routine first obtains 
the address of the STAE user's RB from the 
RBLINK field of the STAE SVRB. If the STAE 
macro instruction has been issued in the 
user' s STAE exit routine , an error code of 
8 is placed in register 15 f and control is 
returned to the user. The STAE request is 
not serviced, since the user's STAE exit 
routine processing is already attempting to 
deal with an error. STAE next tests the 
contents of register to determine the 
kind of request — to create, to cancel, or 
to overlay a STAE control block (SCB) . 

If register contains a (the create 
option), the address of the user's exit 
routine and parameter list specified in the 
STAE macro instruction are checked. If 
either address is invalid, an error code of 
12 is placed in register 15, and control is 
returned to the user. If both addresses 
are valid, STAE issues a conditional GET- 
MAIN macro instruction requesting 16 bytes 
of main storage for an SCB. 

1. If main storage is not available, con- 
trol is returned to the user with the 
return code 4 i n register 15. 

2. If main storage is available, the SCB 
is initialized by placing the address 
of the previous SCB, or 0, in the 
first word, the address of the user's 



STAE exit routine in the second word, 
the address of the user's exit routine 
parameter list in the third word, and 
the address of the user's RB in the 
fourth word. The address of the newly 
created SCB is placed in the last 3 
bytes of the TCBNSTAE field of the TCB 
(displacement decimal 160). 



If XCTL=YES was coded in the STAE 
macro instruction (the high order bit 
of register 1 is on) , STAE turns on 
the XCTL flag (bit 2) in the TCBNSTAE 
flag field to prevent cancellation of 
this SCB when an XCTL macro instruc- 
tion is issued. 



If register does not contain 0, or if 
register contains a but the address of 
the user's STAE exit routine is 0, either 
the cancel or the overlay option is being 
specified. STAE tests the TCBNSTAE field 
to determine whether an SCB is already in 
effect. If it is 0, indicating that one is 
not, an error code of 8 is placed in 
register 15, and control is returned to the 
user, since an SCB that does not exist can- 
not be canceled or overlayed. If an SCB is 
in effect, STAE continues processing. 

STAE next compares the fourth word of 
the SCB in effect with the address of the 
RB for the task that is requesting that the 
SCB be canceled or overlayed. If the 
addresses are not the same, a return code 
of 16 is placed in register 15, and control 
is returned to the user. This test pre- 
vents the destruction of an SCB belonging 
to another program. 

The STAE routine now determines whether 
the STAE request is to cancel or to overlay 
an SCB. 

• If register contains a 4 (the cancel 
option) , the addresses of the previous 
SCB, which is contained in the first 
word of the SCB in effect, is moved 
into the TCBNSTAE field. A FREEMAIN 
macro instruction is then issued to 
free the main storage occupied by the 
canceled SCB. 

• If register contains an 8 (the over- 
lay option), the address of the user's 
exit routine and STAE parameter list 
are obtained and checked. If either 
address is invalid, an error code of 12 
is placed in register 15, and control 
is returned to the user. If both 
addresses are valid, they are moved 
into the second and third words, re- 
spectively, of the SCB in effect. If 
the XCTL option is specified, the XCTL 
flag (bit 2) in the TCBNSTAE flag field 
is turned on. 
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When control is returned to the user 
from STAE, register 15 contains one of the 
following return codes: 

Code Indication 
00 A STAE request is successfully 

created, overlayed, or canceled. 

04 Storage for the STAE request is not 
available. 

08 The user is attempting to cancel or 
overlay a nonexistent STAE request 
or is issuing a STAE in his exit 
routine. 

0C The address of the exit routine or 
the parameter list is invalid. 

10 The user is attempting to cancel or 
overlay a STAE request not asso- 
ciated with his request block (RB) . 
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NORMAL AND ABNORMAL TERMINATION ROUTINES 



In the following descriptions of the 
Normal and Abnormal Termination routines, 
condition/action tables are used where 
feasible to describe module processing. 
Where the condition in the left column is 
met r the action in the right column is 
taken. If the condition is not met, the 
processing for the condition/action in the 
following line occurs. If no condition is 
given, the action in the right column is 
always taken, unless the condition/action 
has been bypassed as a result of a previous 
action. 



ABEND — NORMAL TERMINATION AND ABNORMAL 
ROUTING (IEANTMOO) CHART CA 

ABEND is the first module entered to 
process normal and abnormal terminations. 
Processing of normal terminations is 
described below. 



If entered because of an abnormal ter- 
mination, ABEND passes control to ABEND 
G. However, before exiting to ABEND G, 
ABEND determines if there is sufficient 
main storage available for the SVRB created 
for the XCTL. If not, and if the task 
being terminated is a job step and the SVRB 
pool within the SVC SLIH is unavailable, 
ABEND will steal storage from within the 
partition for the creation of the XCTL 
SVRB. 



I- — 

' l. 

i- 



2. 

h 

3. 

J- — 



Condition 



Action 



Entry from IEANTMOB|Go to step 9 



Interval timer 
exist 



Store completion code. 



TQE in use 



1. MCS in system 



WTOR requests to 
purge 



Subtask terminating 



10. Limit priority does 
not equal dispatch- 
ing priority 



11. 



12. Small partition 



1 

1 

1 



Set IQE pointer to TQE to zero. 



Issue TTIMER CANCEL. 



Close DCBs, dequeue DEBs for 
task. 



Pass control to IEACTflOB (ABEND 
11). 



Pass control to IEANTMOB 
(ABEND 11) 



Pass control to IEANTMOC (ABEND 
12) 



Dequeue IQEs for terminating 
task. 



Issue CHAP macro instruction 



Initialize boundary box and FQE 
for hierarchy (and hierarchy 
1, if applicable), clear poin- 
ters to TIOT and problem pro- 
gram save area. 



I 

|13. 

L 



Pass control to IEFSD599 
(SMALLGO) . 

| Pass control to IEFSD515 (GO). | 



If the task to be terminated is a sub- 
task, ABTERM is invoked to abnormally ter- 
minate the job step, and a WAIT macro 
instruction is issued. 
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ABEND G — ABNORMAL TERMINATION AND ABEND 
RECURSION (IEANTMOG) CHART CB 



ABEND 1 — ABEND/STAE GRAPHICS LINKAGE 
(IEANTM01) CHART CC 



ABEND G provides initial processing for 
abnormal terminations and provides the 
interface to the OLTEP STAE Exit routine if 
OLTEP is the failing task. 



I 

7. 

j. 

8. 

I 

9. 

J. 

10. 

I- 

11. 



Condition 



I 



Return from IEANTMOM 



Failure in SVC DUMP 



Not ABEND recursion 



Not DAR recursion 



Primary DAR 
recursion 



Not valid CLOSE 
recursion after DAR 



Job step ABEND 



Subtask ABEND 
(invalid) 






ABTERM not entered 



f 



Pass control to IEANTM02 
(ABEND 2) . 

Go to step 18 . 

Store completion code. 






Purge fail in STAE 






12. Valid STAE issued; 
ABEND not caused by 
operator's cancel, 
timer expiration, 
invalid DETACH, or 
STAE recursion. 



Step ABEND request 



System task, must 
complete status, or 
Scheduler or Writer 
ABEND. 



15. 



Entries in message 
information list. 



16. 



17. Job step ABEND 



18. 



Go to step 16. 



Set all tasks dispatchable, 
turn on trace table, restore 
NEW in IEATCBP. 



Go to step 9. 



Go to step 16. 



Pass control to IEADTM22 
(DAR 1). 



Pass control to IEADTM23 
(DAR 2). 



.| 



-H 



Issue HOOK macro instruction 
to disable GTF. 



Store address of SVC 3 in cal- 
ler's RB, pass control to 
IEAATA00 (EXIT). 



Free PIE, indicate ABTERM 
entered, indicate first ABEND 
entry from STAE, pass control 
to IEASTM11 (ASIR 1) . 



H 



Go to step 18. 



Pass control to IEANTM01 
(ABEND 1). 



Pass control to IEANTMOM 
(ABEND M). 



Clear entries in list, free 
ABEND M WTO buffer. 



Pass control to IEANTM01 
(ABEND 1). 



Use ABTERM to abnormally ter- 
minate job step, issue WAIT 
macro instruction (never 
posted) . 



ABEND 1 processes nonrecursive termina- 
tions for all tasks or for failures when 
GJP is included in the system. The follow- 
ing table gives the possible conditions 
within the module and the resulting action 
taken. 



Condition 



Action 



, + 

|1. Graphics recursion | Pass control to graphics hook 
I | routine. 



j. 

| 2. GTF is terminating | Permanently disable GTF. 



H 



|3. 



| Purge task of IQEs, active TQEs, 
|SPIE requests, transient area 
{requests, and STAE requests. 



| 4. Terminating task | Perform step 3 for each subtask 
| has subtasks |of terminating task. 
| 



15. 



| Pass control to IEACTMOB (MCS) or 
|IEANTM0B (non-MCS) ABEND 11. 



ABEND 2 



PURGE I/O (IEANTM02) CHART CD 



Condition 



Action Taken 



j. 

| Nonrecursive ABEND 
I 



| Purge I/O for terminating 
| task and any subtasks 



| 

| Recursive ABEND | Purge I/O for terminating 

| | task only 

| System task terminating, |Exit to DAR 1 (IEADTM22) 

| terminating task is in | 

j "must complete" status, or | 

jwriter or Scheduler failure| 

V + , 



| Nonrecursive ABEND 
| 

I Recursive ABEND 



| Exit to ABEND 3 
_ + 

| Exit to ABEND 9 



H 



ABEND 3 — CONTROL BLOCK VALIDITY CHECK 
(IEANTM03) CHART CD 

ABEND 3 tests the validity of the con- 
trol blocks associated with a nonrecursive 
terminating task. This ensures system 
integrity by preventing an abnormal ter- 
mination within ABEND. Except for certain 
FQE conditions , invalid control blocks 
cause the termination of the queue on which 
they reside after the last valid control 
block. The table below gives the validity 
checks for each control block. Where an 
FQE condition is indicated by a bullet (•)* 
the FQE is dequeued, but the queue is not 
terminated. 



This process is duplicated for all sub- 
tasks of the terminating job step. GQE and 
JPAQ control blocks may exist only if sub- 
tasking is included in the system. 
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Validity Requirements 



| Alignment on a fullword boundary 

h 



j Alignment on a doubleword boundary 



j Block not in free core 

| 

j Maximum of 300 blocks on queue 



j Valid forward and backward pointers 
, 

| Block size is a multiple of 8 



j Block does not extend beyond parti - 
jtion boundary 

| Block does not describe an area 
| described by an FQE 

| Block resides in the partition 






+ f 



| Blocks are queued in descending 
j order 

i 



FQE 



Load 
List 



f 



Active 

RB 



-+— 



1 

1 

1 



ABEND 3 exits to ABEND J for MFT with sub- 
tasking or to ABEND 4 without subtasking. 



ABEND 5 — OPEN DUMP DATA SET (IEANTM05; 
WITH SUBTASKING) CHART CF 

ABEND 5 opens the dump data set if 
necessary for the terminating task. This 
data set remains open until termination of 
the job-step task, and need not be reopened 
for subsequent ABEND processing. Any sub- 
tasks of the terminating task that are 
enqueued on the dump data set are dequeued 
by a branch entry to DEQ since these sub- 
tasks are nondispatchable. An ENQ macro 
instruction is issued on the dump data set 
to prevent other tasks from using it until 
the dump is finished. If the data set can- 
not be opened, or if a SYSABEND or SYSUDUMP 
entry is not found in the TIOT, ABEND 5 
exits to ABEND 9. If any task in the job 
step is in the process of opening the dump 
data set, the current task is set nondis- 
patchable, its resume PSW is set to reenter 
this module, and control is passed to the 
Dispatcher. If the data set is opened, all 
tasks in the job step that were set nondis- 
patchable while waiting for the dump data 
set to open are reset dispatchable, and 
control is passed to ABEND 6. 



ABEND 4 — DUMP TEST (IEANTM04) CHART CE 



ABEND 4 determines if a dump is required 
and ensures that sufficient main storage is 
available for any type of dump, for an ENQ 
purge, or for a CLOSE. A dump is not given 
if there is insufficient main storage 
available for the dump. If a SYSABEND or 
SYSUDUMP DD name is not found in the TIOT, 
an indicative dump is given. The following 
table gives the conditions possible within 
the module and the exits taken. 



Condition 



♦Full dump requested 



Indicative dump requested 



Insufficient main storage available for 
providing dump 



| Exit Taken | 

-+ \ 

| IEANTM05 j 

-+ ^ 

j IEANTM08 j 
-+ 1 



j IEANTMOA j 
I I 



♦ABEND is for subtask 



♦Subtasks need ENQ purge 



j IEANTMOC j 
-+- 



IEANTMOD 



| ♦Subtasks do not need ENQ purge 
I— 



h- 



Job step termination 



♦MFT with subtasking only 



j IEANTMOE j 

-+ ^ 

| IEANTM07 | 
-J. 4 



ABEND 5 — OPEN DUMP DATA SET (IEAMTM05; 
WITHOUT SUBTASKING) 

If a SYSABEND or SYSUDUMP DD name is not 
found in the TIOT, or if the data set can- 
not be opened, ABEND 5 exits to ABEND 9. 
ABEND 5 opens the dump data set for the 
terminating task and exits to ABEND 6. 



ABEND 6 — DUMP (IEANTM06) CHART CG 

ABEND 6 prints appropriate messages per- 
tinent to the dump and issues a SNAP macro 
instruction (SVC 51) to call ABDUMP for the 
terminating task. 

If GTF is active and formatting has been 
requested, ABEND 6 sets up the SNAP parame- 
ter list to indicate that ABDUMP is to for- 
mat the GTF trace data. If formatting has 
been requested, GTF tracing will be sus- 
pended during the dump. 

In MFT without subtasking, if GTF is 
inactive and the trace table was included 
during system generation, the SNAP parame- 
ters are set to dump the trace table. 

For MFT with subtasking ABDUMP is 
invoked for all subtasks. 

The following table gives the conditions 
within the module and the exits taken. 



Condition 



j*Job step task has no subtasks 



"T 1 

| Exit Taken | 

-+ ^ 

| IEANTM07 j 



j SNAP macro instruction failed 
j 

| *Subtask is terminating 



| IEANTM09 j 

-+ ^ 

j IEANTMOC j 



j*Subtask needs ENQ purge 



-+- 



H 



j*Subtasks do not need ENQ purge 



j IEANTMOD 
j IEANTMOE j 



j Job step termination 



|*MFT with subtasking only 



| IEANTM07 | 
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ABEND 7 — TERMINATION (IEANTMQ7) CHART CH 

IEANTM07 first determines if GTF tracing 
is suspended. If it is, the HOOK routine 
is used to restart the tracing. IEANTM07 
tests the OLTEP bit in the TCBRTRN field of 
the TCB to determine if system restoration 
is required for the OLTEP task. If so, 
ABEND 7 issues an SVC 59 for performance of 
the cleanup functions necessary for system 
restoration. 

Then, ABEND 7 closes all data sets 
chained to the TCB of the terminating task, 
dequeues IQEs, and clears the pointers to 
the ABEND appendages and transient area 
queues. If an indicative dump has been 
created, it is moved to the upper part of 
the partition (end-632). If TCAM is 
abnormally terminating, ABEND 7 passes con- 
trol to the TCAM termination module 
IEAQTMOQ which will return control to ABEND 
7 when it completes processing. IEANTM07 
exits through the dummy program to GO 
(IEFSD515) if its partition size is equal 
to or larger than the scheduler, or, if 
smaller, to SMALLGO (IEFSD599). 

If subtasking is included in the system, 
this module is entered only if a job step 
task is terminating and its subtask's TCB 
has been freed. 



ABEND 8 — INDICATIVE DUMP (IEANTM08) 
CHART CH 

ABEND 8 creates an indicative dump area 
(for job step termination only) containing 
the following information: 

• Register contents at entry to ABEND 

• Floating-point register contents, if 
any 

o Completion code 

• Program- check instruction if a program 
interruption occurred. 

• TCB flags 



• Program name 

• Entry point 

• Resume PSW 

• Active RBs 

• Loaded RBs 

ABEND 8 exits to ABEND 7 for job step 
termination. 

If subtasking is included in the system, 
ABEND 8 exits to ABEND 13 to purge 
resources allocated to subtasks by ENQ, or 
to ABEND 15 if subtasks do not have allo- 
cated resources. If no subtasks exist, 
ABEND 8 exits to ABEND 7. 



ABEND 9 — RECURSION PROCESSING (IEANTM09) 
CHART CI 

ABEND 9 dequeues all request blocks 
created as a result of the recursion and 
processes all OPEN, CLOSE, ABDUMP, and mes- 
sage recursions. The following table gives 
the conditions possible within the module 
and the actions taken. 



H- 



♦OPEN recursion | Reestablish JPAQ chain, reset dis- 
jpatchable any tasks waiting for 
j open of dump data set. 

♦Subtask ABEND (Reestablish GQE chain, 
h 



Condition 



I 



Action 



Message recursion (Pass control to IEANTM04 (ABEND 4). 



■+- 



OPEN recursion 



CLOSE recursion 



l~ 



.| 

(Set flag for indicative dump, reset 
| dispatchable any tasks waiting for 
| open of dump data set. 

j Indicate no dump. 



♦ABDUMP recursion |Free the ABDUMP work area, set flag 
| for indicative dump, issue DEQ 
| macro instruction for dump data 
| set. 



t- 



ABDUMP recursion |Free the ABDUMP work area, set flag 
| for indicative dump. 
+ 

| Pass control to IEANTMOH (ABEND H) . 



*MFT with subtasting only 
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ABEND 10 — STEAL MAIN STORAGE (IEANTMOA) 
CHART CJ 



ABEND 12 — LOADING PROGRAM PURGE 
(IEANTMOC; WITH SUBTASKING ONLY) CHART CK 



ABEND 10 steals main storage from the 
problem program partition whenever ABEND 4 
determines that sufficient free main 
storage is not available for ABEND to per- 
form its essential functions. 



ABEND 12 is entered only when the ter- 
minating task is a subtask. Partially 
loaded programs and FRBs for the terminat- 
ing task and its subtasks are freed, all 
SNAP nondispatchability flags are cleared, 
and control is passed to ABEND 13. 



| Condition | Action | 

I. + , 

| Job step ABEND | Free storage occupied by programs 
on JPAQ . 



(Terminating task has 
| subtasks 



j ABEND SVRB is in PRB 
I area 

j. 

|FQE is in PRB area 
j. _ 



j Terminating task has 

| subtakks 

I 



j. 

| Dump requested, but 
jnot enough storage 
| could be freed 

n 

i 



JTask owns SVRB pool 



, 

| All used SVRBs in 

j pool copied 

| 



H 

Free main storage occupied by pro- 
grams on Load List. 



Free main storage occupied by 
programs on Load Lisss of 
subtasks. 



Move SVRB to top of partition. 



Dequeue FQE 



Free main storage occupied by pro- 
grams on active RB queue. 

Free main storage occupied by 
programs on subtasks' active RB 
queue. 



Turn off flag indicating dump to 
be given, indicate message needed. 



Obtain main storage and copy SVRB 
from pool into obtained storage, 
and indicate copied SVRBs free. 



Indicate task no longer owns SVRB 
pool. 



Pass control to IEANTM04 (ABEND 
4). 



ABEND 13 — SUBTASK ENQ PURGE (IEANTM0D; 
WITH SUBTASKING ONLY) CHART CK 

ABEND 13 releases allocated resources 
for all subtasks of the terminating task 
and for the terminating task itself if it 
is a subtask. Outstanding ENQs for the job 
step task will be purged by the job manage- 
ment routines IEFSD597 or IEFSD598 at step 
termination. ABEND 13 exits to ABEND 15. 



ABEND 14 — DATA SET CLOSE (IEANTMOE; WITH 
SUBTASKING ONLY) CHART CL 

ABEND 14 is entered from ABEND 15 to 
complete subtask termination. For abnormal 
termination , all open data sets for the 
terminating task are closed. If there is 
not sufficient main storage available for 
close processing, ABTERM is entered to 
schedule abnormal termination of the job 
step. If TCAM is abnormally terminating , 
ABEND 14 passes control to the TCAM ter- 
mination module IEAQTMOQ which returns con- 
trol to ABEND 14 upon completion of its 
processing. For both normal and abnormal 
termination, ABEND 14 removes from the RB 
queue all RBs except the SVRB for ABEND. 
All GQEs are freed, the task is set nondis- 
pat enable, and is indicated as terminated. 
ABEND 14 then passes control to the SVC 
EXIT routine IEAATA00. 



ABEND 11 — WTQR PURGE (IEANTMOB; WITHOUT 
MULTIPLE CONSOLE SUPPORT) CHART CK 

ABEND 11 ensures an end line in all 
multiple-line WTO messages and purges out- 
standing WTOR requests for the terminating 
task and exits to ABEND for normal job 
step termination, or to ABEND 2 for abnorm- 
al termination. 

Exits are to ABEND 12 for normal subtask 
termination, or to ASIR 3 if STAE was the 
requester. 



ABEND 15 



IQE PURGE AND SUBTASK CLEANUP 



(IEANTMOE; WITH SUBTASKING ONLY) CHART CM 

ABEND 15 purges IQEs for the terminating 
task and any subtasks. If the top task is 
a subtask terminating normally, minor LPRBs 
are freed, any entries in the TSCE for the 
task are removed, and ABEND 15 passes con- 
trol to ABEND 14. For abnormal termina- 
tion, all DEBs and GQEs of any daughter 
tasks are chained to the TCB of the ter- 
minating task, and minor LPRBs are dequeued 
and freed. Any entries in the TSCE for the 
daughter tasks are removed. 



ABEND 11 — WTOR PURGE (IEACTMOB; WITH 
MULTIPLE CONSOLE SUPPORT) 

ABEND 11 (IEACTMOB) has the same func- 
tions and exits as ABEND 11 (IEANTMOB) 
(above) . 



For GTF, a check is made for subtasks 
that are abnormally terminating or issuing 
SNAP dumps to ensure that the GTF tracing 
is resumed for the terminating task. Then, 
main storage associated with any SCBs is 
freed. Finally, the subtask TCBs are 
removed from the TCB queue and their main 
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storage is freed. If the job step is 
abnormally terminating, ABEND 15 passes 
control to ABEND 7. Otherwise, ABEND 15 
passes control to ABEND 14. 



ABEND M — WTP PROCESSING FOR TYPE 1 SVC 
ROUTINES (IEANTMOM) CHART CN 

ABEND M receives control from ABEND G if 
there is a WTP message to be issued for a 
Type 1 SVC routine. The Message Informa- 
tion List entries are scanned for a match- 
ing TCB. ABEND M then builds a parameter 
list in the extended save area of the cur- 
rent RB and issues a conditional GETMAIN 
macro instruction for a message buffer. If 
the GETMAIN is successful, ABEND M issues 
the WTP message and returns to ABEND G. If 
the GETMAIN is not successful, ABEND M sets 
the length in the GETMAIN parameter list to 
zero, and returns to ABEND G. 



ABEND H 



WTO ISSUING FOR VALID RECURSIONS 



(IEANTMOH) CHART CO 

ABEND H receives control from ABEND 9 
after an OPEN, CLOSE, or ABDUMP recursion 
to issue a WTO message identifying the 
recursion. ABEND H tests for availability 
of storage for WTO processing before issu- 
ing the message and, if sufficient storage 
is not available, the message is not 
issued. ABEND H returns control to ABEND 
4. 



ABEND J — JPAQ AND GQE VALIDITY CHECK 
(IEANTMOJ) CHART CP 



Condition 



1. Caller is the XSNT 
Area Task* 



TCB address not on 
fullword boundary 
and Type 1 SVC 
switch on 



TCB address not on 
fullword boundary 
and Type 1 switch 
not on 



ABEND is the caller 
(ABEND bit on in the 
TCB) 



5. STAE process pro- 
gressing 



6. ABTERM has had con- 
trol previously 



8. 



ABEND is the caller 



h 

10. The current task is 
not terminating and 
the terminating task 
has a higher prior- 
ity than the current 
task 
| 

11. 



12. Type 1 SVC switch is 
on 



13. 



Type 1 SVC switch is 
not on 



1. Exit to the Reinstate XSNT 
Routine 



2. Set SVC Old PSW to an SVC 
13 (ABEND) and exit to the 
FLIH at entry point 
DISMISS 



3. Exit to the Dispatcher 



4. Go to action 8 



Go to action 7 



H 

6. Exit to the caller because 
the PSW has already been set 

to an SVC 13 
1 

7. Store the completion code 

8. Turn on the ABTERM bit in 
the TCB, prevent asynch- 
ronous exits 



9. Store the completion code 
in the ABEND appendage 



10. Set the terminating task 
for immediate dispatching 



11. 



Turn off the pseudo- 
di sable switch 



12. Set the SVC Old PSW to an 
SVC 13, turn off the SVC 
nesting switch, and exit 
to the caller 



13. Set the RB wait count to 
0, set the resume PSW to an 
SVC 13, and exit to the 
caller 



♦The XSNT Area Task coordinates all loading of the 
transient area. It is external to ABTERM. 






ABEND J receives control from ABEND 3 to 
validity check RBs on the job pack area 
queue and gotten subtask area queue ele- 
ments (GQEs) . Both must be within the par- 
tition, aligned on a doubleword boundary, 
and within allocated storage. The RBs on 
the JPAQ must also have valid forward and 
backward pointers. GQEs must not extend 
beyond the partition boundary, must not 
describe an area described by an FQE, and 
must have a size that is a multiple of 8. 
ABEND J returns control to ABEND 4. 



ABTERM — (IEAIAB00; WITH THE TRACE TABLE) 

This module is exactly the same as 
IEAGAB00 except that it contains the 
address of the Trace Stop routine so that 
it can be referred to by ABEND and SVC 
DUMP1. 



ABTERM 



( IEANAMQO ; WITH SUBTASKING) 



CHART CY 



ABTERM — (IEAGAB00; WITHOUT THE TRACE 
TABLE) CHART CY 

The ABTERM routine is used to force a 
specified routine to terminate. 



This module is exactly the same as 
IEAGAB00 except that before "Resulting 
Action 13" (see table above) , the terminat- 
ing task would be set dispatchable. 
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ASIR 1 — ABEND/STAE INTERFACE ROUTINE 1 
(IEASTM11) CHART CQ 

ASIR 1 receives control when ABEND 
determines that the terminating program has 
issued a STAE macro instruction. It sched- 
ules the user's exit routine and routes 
control for a retry if one was requested. 
If a retry is scheduled r ASIR 1 purges the 
Message Information List of all entries for 
the current TCB. 



1 


" I 

Condition | 


— _ _ ., 

Action | 

_ j 


1 1- 1 


1. 


i 

Set STAE recursion flag in| 

TCB to prevent second | 

entry into STAE | 

_ _ _j 


1 2. 

1- 

1 3. 


i 
Current task in must 
complete status and | 
user not in supervi- 
sor state | 

SIRB on the RB queue 


2. 
3. 


1 
Issue an ABEND | 

Issue an ABEND to prevent | 

interlock j 

_ _ _i 


1 **• 

L 


Current SCB invalid 
(RB address in SCB | 
does not point to an 
RB on the RB queue | 
but more SCBs exist 


4. 


Dequeue and free storage | 
for the invalid SCB there- | 
by making the previous SCB| 
current, repeat Condition | 
4 I 
_ _ _ j 


1 5. 


Current SCB invalid 
with no more SCBs 


5. 


— 1 

Issue an ABEND macro | 

instruction j 

__. „„^ ^ j 


1 6. 


Current SCB valid 


6. 


■ — 1 

Purge I/O with quiesce | 

option | 

_ j 


1 7. 
1 8. 


Purge not successful 


7. 

8. 


— - -j 
Purge I/O with halt option | 

Conditional GETMAIN for | 

work area and register | 

save area j 

_ _ _ — J 


1 9. 


Sufficient storage 
available 


9. 


1 

Initialize work area and | 

set parameter registers j 

- - 4 


|10. 


Sufficient storage 
not available 


10. 


— - -j 

Set parameter registers | 


|11. 


11. 


SYNCH - schedule user exitj 
routine | 


|12. 


12. 


Free register save area if j 
one was acquired | 


|13. 

|m. 


Retry not requested 

Retry requested 
without purge of RB 
queue and user in 
supervisor mode 


13. 
14. 


Issue an ABEND | 
Pass control to ASIR 3 j 

_4 


|15. 


Retry requested 
without purge of RV 
queue and user not 
in supervisor state 


15. 


^ .-.,. — T ^ 

Issue an ABEND macro | 
instruction | 


1 16. 

L _ 


Retry requested with 
purge of RB queue 
and user in 
supervisor state 

j 


16. 

L 


XCTL to ASIR 2 | 


r 

|17. 

l~ - 


Retry requested with 
purge of RB queue 
and user not in 
supervisor state 


r 

|17. 


Verify retry routine and | 
parameter list addresses | 


r 

|18. 

1- 

|19. 


Addresses not valid 


|18. 

f 

|19. 


Issues an ABEND | 
Pass control to ASIR 2 j 



ASIR 2 — ABEND/STAE INTERFACE ROUTINE 2 
(IEASTM12) CHART CR 

ASIR 2 receives control when ASIR 1 
determines that the RB queue must be purged 
before the retry routine is scheduled. 
Since all RBs between the abnormally ter- 
minating RB for the task and the RB for the 
program that issued the STAE will be 
purged, all their restorable IOBs must be 
dequeued and all their open data sets must 
be closed. 

ASIR 2 dequeues IOBs and closes DCBs, 
unless the DCB organization is in the ISAM 
or TAM groups, for all RBs (SVRBs excluded) 
that will be purged. If any ISAM or TAM 
DCBs were encountered, ASIR 2 passes con- 
trol to ASIR 4 to have them closed. Other- 
wise, control goes to ABEND 11 to purge the 
WTOR reply queue. 



ASIR 3 — ABEND/STAE INTERFACE ROUTINE 3 
(IEASTM13) CHART CS 



ASIR 3 receives control whenever a retry 
has been requested. If the user specified 
a purge of the RB queue, the resume PSW 
address in all RBs between the RB for the 
terminating task and the RB for the program 
that issued the STAE are set to an SVC 3 
(EXIT) instruction. The SCB is then freed, 
the work area (if one was acquired by ASIR 
1) is reinitialized, and the parameter 
registers are set. The resume PSW of the 
STAE user is set to point to the Retry rou- 
tine, and control is passed to the 
dispatcher. 

If no purge was requested, a new RB is 
created, initialized for the Retry routine, 
and queued on the RB chain. The SCB is 
freed, the work area is reinitialized, the 
parameter registers are set, and control is 
passed to the Dispatcher. 



ASIR 4 — ABEND/STAE INTERFACE ROUTINE 4 
(IEASTM14) CHART CT 

ASIR 4 receives control from ASIR 2 to 
close DCBs organized in the ISAM and TAM 
group and dequeue the IOBs related to them, 
for the RBs that are going to be purged. 
Upon completion, ASIR 4 passes control to 
ABEND 11 to purge the WTOR reply queue. 



PAR 1 — DAMAGE ASSESSMENT ROUTINE 1 
(IEADTM22) CHART CU 

DAR 1 is called to dump main storage 
when ABEND detects a failing task in must 
complete status, a failing system task, or 
an invalid recursion. 
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If any of the following conditions are 
found, DAR will not attempt to write the 
dump: 



1. Main storage was stolen by ABEND or 
DAR, 



2. Storage is not available in the parti- 
tion to schedule SVC DUMP. 

3. This entry is a primary DAR recursion 

(a previous failure to write the 
dump) • 

4. The SYS1.DUMP data set has not been 
allocated. 

If any of these conditions exists, DAR 1 
purges the message information list and 
writes an appropriate message to the con- 
sole. It then traces the RB queue to 
determine whether the SIRB is enqueued. If 
it is, it is dequeued. If the failing task 
is a system task and is not in "must com- 
plete" status, control is passed to DAR 2 
(IEADTM23). For all other failing tasks, 
control is passed to DAR 3 (IEADTM24). 

If the failing task is in "must com- 
plete" status and there is not enough main 
storage for WTO processing, DAR 1 "steals" 
main storage for the messages. 

Otherwise, DAR 1 calls the SVC DUMP (SVC 
51) routine to write the dump of main 
storage to the SYS1.DUMP data set. When 
control is returned, DAR 1 exits as before. 



DAR 3 



DAMAGE ASSESSMENT ROUTINE 3 



(IEADTM24) CHART CW 

If DAR 3 is entered because of a secon- 
dary DAR recursion for a subtask, ABTERM is 
entered to schedule abnormal termination of 
the job step. If a job step is terminat- 
ing, a HOOK macro instruction is issued to 
resume GTF tracing, a task reinstatement 
failed message is written, and control is 
passed to DAR 4. 

If this is not a secondary DAR recur- 
sion, and resources are not critical, a task 
reinstatement message is written, appropri- 
ate nondispatchable flags are set, and con- 
trol is passed to ABEND 3. 

If resources are critical, a task rein- 
statement failed message is written and 
control is passed to DAR 4. 

If the task is in "must complete" sta- 
tus, processing is the same as for 
resources not critical (above) . 



DAR 4 — DAMAGE ASSESSMENT ROUTINE 4 
(IEADTM24) CHART CX 

DAR 4 enters IEAASPRG for subsystem 
cleanup and sets the failing task per- 
manently nondispatchable. If GTF tracing 
is to be resumed,, a HOOK macro instruction 
is issued to effect this. DAR 4 sets NEW 
(IEATCBP) to the address of the highest 
priority ready TCB and branches to the 
Dispatcher. 



For MFT with subt asking, all tasks 
related to the failing task are marked for 
termination. Also, there is no special 
handling of the SIRB. 



SVC DUMP (IEAAADOY, IEAAADOZ) CHARTS DA AND 
DB 

SVC DUMP provides a dump of selected 
areas of main storage to either tape or a 
direct access device. 



DAR 2 — DAMAGE ASSESSMENT ROUTINE 2 
(IEADTM23) CHART CV 



If DAR was invoked by a failing system 
task that is not in "must complete" status, 
DAR 2 attempts to reinstate the task to 
avoid a Wait state in the CPU. DAR 2 
writes a task reinstatement message to the 
operator (unless main storage has been sto- 
len) , sets the top RB to the reinitialize 
routine, sets the wait count to 0, and 
passes control to the Dispatcher. 

For MFT with subtasking, a check is made 
to determine if the failing task is a sys- 
tem error task operating on behalf of 
another task. If it is, ABTERM is used to 
schedule the abnormal termination of the 
requesting task and then DAR 2 passes con- 
trol to the Dispatcher. 



SVC DUMP 1 (IEAAADOY) is entered when 
the caller issues an SVC 51. Initially, 
SVC DUMP 1 determines if this is a SNAP or 
SDUMP request. The ninth byte (offset 8) 
in the parameter list is set to X^O* if 
this is an SDUMP request. For a SNAP requ- 
est, SVC DUMP 1 passes control to ABDUMP 1. 

SVC DUMP 1 checks the highest level RB 
of the invoking task to ensure it is 
operating with a protection key of 0, that 
is, to ensure that it is in supervisor 
state. If it is not, the dump exits with a 
return code. 

The lock byte is then tested to deter- 
mine whether a dump is already in progress. 
If it is, the dump exits with a return 
code. If it is not, the lock byte is set 
in order to prevent simultaneous access to 
dump data sets. Next, all tasks except the 
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Communications Task, Transient Area Loading 
Task, System Error Task, and current task 
are set nondispatchable and the dump- 
invoked bit in the TCB is turned on. 

If the DCB operand is 0, the SYS1.DUMP 
data set is assigned by default. If the 
SYS1.DUMP data set is not available or if 
the DCB for the data set is not open, SVC 
DUMP 1 performs exiting procedures (below). 

SVC DUMP 1 then issues the TIME DEC 
macro instruction to obtain the date and 
time. These are stored in the header 
record. 

The UCB representing the device upon 
which the dump data set resides is checked 
to ensure that it is in the "ready" state. 
If it is not, a return code is set and the 
routine exits after resetting dispatchabi- 
lity bits and the lock byte. The device 
type, either tape or direct access, is then 
determined and initialization of the con- 
trol blocks is completed as required. 

The trace table, if present, or GTF, if 
active, is made inoperative for the dura- 
tion of the dump so that entries leading up 
to the failure are preserved. Prior to 
exiting, the trace facilities will be 
reactivated. 

If the device is direct access, a test 
is required to determine if the data set is 
available to receive a core image dump. A 
channel program is initialized to read the 
first record on the data set. If end-of - 
file is not detected, the data set already 
contains a core image dump, in which case a 
return code is set and the routine exits. 
Otherwise, the data set is empty and avail- 
able to receive a core image dump. The 
user supplied header record is the first 
data block written. After this the channel 
programs are reinitialized to perform the 
actual writing of the core image dump. 

Abnormal end, channel end, and program 
controlled interrupt (PCI) appendages are 
provided. The writing of the dump is per- 
formed via EXCP and WAIT. The PCI appen- 
dage updates the channel programs required 
to write the core image. The channel end 
and abnormal end appendages restart the 
channel program if end-of- cylinder or if 
I/O errors are encountered. Standard ERPs 
are used while writing the dump except if 
SVC DUMP was invoked due to a failure of 
the System Error Task or if, in MFT without 
subtasking, the SIRB is active. 

An unrecoverable error condition causes 
the writing of the dump to be terminated 
and a return code set prior to exiting. 
Upon completion of the dump, a normal com- 
pletion return code is set. For SYS1.DUMP 
an end-of -file record is written after the 



dump is completed (normally or abnormally) . 
For user DASD data sets, the DCBFDAD field 
in the user f s DCB is filled in with the 
address of the last block written. The 
DCBTRBAL field is set to if the last 
record written filled a track. Otherwise, 
it is set to 1024. These steps are 
required to present a standard DCB inter- 
face to CLOSE. All tasks are set dispatch- 
able prior to exiting, the lock byte is 
reset, and the "dump invoked" bit is turned 
off. Control is then returned to the 
caller. 

If the device is tape, control is passed 
to SVC DUMP 2 (IEAAADOZ). When writing to 
tape, processing is basically the same as 
direct access with the exception that the 
PCI and channel end appendages are not 
used. A tapemark is written only for a 
NIP-allocated tape unit. If the tape is 
user-supplied, no tapemark is written. The 
user must close the DCB. The "LEAVE" 
option may be specified thus allowing mul- 
tiple dumps on tape. 

SVC DUMP 2 checks for unit exception 
after writes to tape. If this occurs, the 
dump is terminated for lack of space. In 
this case, a tapemark is written and the 
tape unloaded. A special return code is 
provided. If a channel data check occurs, 
the dump continues at the next storage 
address to be displayed. 

If dump storage boundaries are indicated 
in the parameter list, the dump routine 
dumps main storage from the addresses spec- 
ified. Beginning addresses are rounded 
down to a 2K boundary; ending addresses are 
rounded up to a 2K boundary. If the para- 
meter list indicates that nucleus and SQA 
are to be dumped, this is done first. All 
parameters are validity checked. If inva- 
lid, the aread defined by the invalid para- 
meters is not dumped. Instead, the para- 
meter pair is marked as invalid, and the 
next set of parameters is examined. 

Upon completion of the last WRITE, SVC 
DUMP 2 returns to the caller after setting 
all tasks dispatchable, turning off the 
lock byte and dump invoked bit, and turning 
on the trace facilities. 



ABDUMP 1 (IEAMAD00) CHART DC 

ABDUMP 1 ensures that all ABDUMP 
requirements have been met. If the DCB has 
not been opened or does not have the proper 
attributes (DSORG=PS, MACRF=W, RECMF=VBA, 
LRECL=125, MFT 2 BLKSIZE=882) a return code 
is placed in register 15, and control is 
returned to the caller. The TCB address is 
also verified and any error results in an 
error code and a return to the caller. 
Otherwise, ABDUMP 1 acquires and initial- 
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izes a 672-byte work area and loads into it 
the output routine that is used by all 
loads of ABDUMP. If enough main storage is 
available , a buffer is acquired to facili- 
tiate the operation of the Output Routine. 
A test is made to determine if SNAP is the 
caller and if trace data is requested in 
the dump. If both cases are true, and if 
GTF is inactive and the Trace Table is pre- 
sent, tracing in the Trace Table is tem- 
porarily suspended to preserve the contents 
of the Trace Table. If GTF is active, and 
if the GTF trace records are maintained in 
main storage, the GTF trace is temporarily 
suspended to preserve the GTF trace data 
while the data is being dumped. Control is 
then passed to ABDUMP 2. 

To avoid any modification of the super- 
visor queues, all subtasks of the job step 
(except for the current subtask) are set 
nondispatchable before control is passed. 



• The RBs on the active RB queue 

• The RBs on the load list 
Control is then passed to ABDUMP 4. 

ABDUMP 4 (IEAAAD01) CHART DE 

ABDUMP 4 writes the remainder of the 
supervisor data as follows: 

• The RBs on the job pack area queue 

• The problem program boundaries 

• The free queue elements 

• The GQEs for all subtasks 

Control is then passed to ABDUMP 5 if a 
save area trace is requested, or to ABDUMP 
6 if it is not. 



ABDUMP 2 (IEAAADOD) CHART DP 

ABDUMP 2 formats and writes the follow- 
ing information common to all types of 
dumps: 

© The heading line of the dump 

• The completion code of the terminating 
task 

• A message indicating the type of inter- 
ruption for 0C1-0C7 interrupts 

• The actual address of the program 
interruption for the types mentioned 
above 

• The resume address at the time of the 
interruption 

• The PSW at entry to ABEND or SNAP 

Control is passed to ABDUMP 3 if super- 
visor data is required. Control is passed 
to ABDUMP 5 if supervisor data is not 
wanted but the save areas are. Control is 
passed to ABDUMP 6 if neither supervisor 
data nor the save areas are requested. 



ABDUMP 3 (IEAAADOA) CHART DP 

If ABDUMP 2 detects that supervisor data 
is wanted by the caller, ABDUMP 3 receives 
control to format and print the following 
portion of supervisor data: 

® The TCB 

• The registers from the TCB save area 
when the current task or subtask is not 
being dumped 



ABDUMP 5 (IEAAAD02) CHART DF 

ABDUMP 5 is entered if the user 
requested a save area trace. Save areas 
are initially displayed in a forward order, 
that is, the order in which the associated 
routines were invoked, starting with the 
supervisor-provided save area. The forward 
trace continues until all program-provided 
save areas have been displayed or until 
incorrect forward or backward chaining of 
save areas has been encountered. Then a 
partial backward trace is performed, pro- 
viding the save area associated with the 
lowest PRB on the chain (the PRB of the 
program being terminated or the program 
that issued the SNAP) and the save area 
indicated by its backpointer. Control is 
then passed to ABDUMP 6. 



ABDUMP 6 (IEAAAD03) CHART DF 

ABDUMP 6 prints, at the user's request, 
the data set information (the DD name, the 
UCB, and the DEB and DCB addresses for open 
data sets) if ABEND did not "steal" any 
storage. The reason for this is that 
ABEND'S "steal" might have destroyed some 
DEBs or DCBs and thus invalidated the par- 
tial list that ABDUMP could provide. Con- 
trol is then passed to the TCAM ABDUMP 
modules if TCAM is in the system and the 
TCAM control program is being dumped. If 
it is not, and if tracing has not been 
requested, control is passed to ABDUMP 8. 
If the optional Trace Table is in the sys- 
tem and GTF is inactive, control is passed 
to ABDUMP 7 to format the Trace Table. 
However, if GTF is active, the optional 
Trace Table output is bypassed and control 
is passed to ABDUMP 13 to format the GTF 
trace data if formatting has been 
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requested. 
ABDUMP 8, 



Otherwise, control is passed to ABDUMP 13 (IEAAADOK) CHART DJ 

ABDUMP 13 formats and prints the GTF 
trace data when the user has requested that 
the data be maintained in main storage. 
ABDUMP 13 gains control from ABDUMP 6 or 
TCAM ABDUMP 4 in GTF is active and if GTF 
is to format the trace data. 



ABDUMP 7 (IEAAADOB) CHART DG 

ABDUMP 7 formats and prints the trace 
table (oldest entry first) when the user 
has requested it. ABDUMP 7 then passes 
control to ABDUMP 8. 



ABDUMP 8 (IEAAAD04) CHART DG 

ABDUMP 8 assembles the EBCDIC translate 
routine and moves it into the work area 
created by ABDUMP 1. If requested , it for- 
mats and writes the register contents that 
were saved at entry to either ABEND or 
SNAP. Control is then passed to ABDUMP 9. 



ABDUMP 9 (IEAAAD05) CHART DH 

If the caller requested it, ABDUMP 9 
dumps the nucleus with its EBCDIC transla- 
tion. Control is then passed to ABDUMP 10 
if a dump of problem- program storage was 
requested or to ABDUMP 11 if it was not. 



If the TIME option was chosen when GTF 
was started, an additional record is 
generated containing the time in the form 
■ seconds. microseconds. f This record fol- 
lows the formatted trace record. When con- 
trol records or error records are encoun- 
tered, control is passed to ABDUMP 14 for 
processing. 

After all records have been formatted, 
GTF tracing is resumed and control is 
passed to ABDUMP 8. 



ABDUMP 14 (IEAAADOM) CHART DK 

ABDUMP 14 formats GTF control records 
(time records and lost- event- count record) 
and prints out the control records, error 
records and error messages. When the reco- 
rd and/or error message has been formatted 
and written, control is returned to ABDUMP 
13. 



ABDUMP 10 (IEAAADOE) CHART DH 

ABDUMP 10 dumps all requested problem- 
program storage with its associated EBCDIC 
translation. Any freed areas within the 
problem program partition are skipped. 
Control is then passed to ABDUMP 11. 



ABDUMP 11 (IEAAADOC) CHART DH 

ABDUMP 11 formats and prints a list of 
specific storage locations which may or may 
not duplicate some other parts of the 
dumped material and can only be requested 
for a dynamic dump (a user issued SNAP 
macro instruction) . These areas are for- 
matted and dumped in the order requested by 
the user. Control is then passed to ABDUMP 
12. 



ABDUMP 12 (IEAAADOF) CHART PI 

ABDUMP 12 formats and prints the END-OF- 
DUMP or END-OF-SNAP message. If a buffer 
was acquired by ABDUMP 1 it is freed along 
with ABDUMP" s work area. Control is then 
returned to the caller (either the user or 
ABEND) . 

For MFT with subtasking, all subtasks of 
the job step are set dispatchable before 
exiting. 



TCAM ABDUMP (IEAAADOG, 1EAAAD0H, IEAAADOI, 
IEAAADOJ) CHARTS PL AND DM 

The TCAM ABDUMP modules receive control 
from ABDUMP 6 when the program being dumped 
is the Telecommunications Access Method 
Message Control Program. 

TCAM ABDUMP 1 (IEAAADOG) formats and 
prints the header line, the Address Vector 
Table (AVT) , and the basic section of the 
Terminal Name Table (TNT) . The AVT is 
dumped in three parts — the basic section, 
the core section, and the disc section. 
Then the TNT section is dumped and control 
is passed to the second TCAM ABDUMP load. 
(Control between all TCAM ABDUMP modules is 
passed via the XCTL macro instruction. ) 

TCAM ABDUMP 2 (IEAAADOH) dumps the 
entries in the TNT and their associated 
Terminal Table (TRM) entries. First, the 
TNT entry is formatted, and immediately 
after, its associated TRM entry is also 
formatted. This is repeated for every TNT 
entry. Control is then passed to the third 
TCAM ABDUMP load. 

TCAM ABDUMP 3 (IEAAADOI) dumps the TCAM 
Destination Queue Control Blocks associated 
with the TRM entries. They are located by 
searching the TNT entries, and are for- 
matted in the order of ascending storage 
locations. After all the queue control 
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blocks have been dumped , control is passed 
to the fourth TCAM ABDUMP load. 

TCAM ABDUMP 4 (IEAAADOJ) dumps the three 
types of TCAM DCBs (line group, message 
queue, and checkpoint) and the Line Control 
Blocks associated with each line group DCB. 
Only open TCAM DCBs are dumped and the 
order in which they are formatted depends 
on the order in which their corresponding 
DEBs are chained. The Line Control Blocks 
for each line group DCB are formatted imme- 
diately after their associated DCBs. 



When all DCBs have been printed, control 
is transferred to ABDUMP if the user has 
not requested trace data. If the user 
requested tracing, and if the optional 
Trace Table is in the system and GTF is 
inactive, control is passed to ABDUMP 7 to 
format and print out the Trace Table. 
However, if GTF is active, the optional 
Trace Table output is bypassed, and control 
is passed to ABDUMP 13 to format and print 
out the GTF trace data if formatting has 
been requested. 
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CONTENTS SUPERVISION ROUTINES 



ATTACH (IEAAATOO; WITHOUT SUBTASKING) 
CHART EA 

Attach searches for the RB of the 
requested routine in the loaded program 
list and the resident reenterable module 
area (optional) . If the RB is not found. 
Attach uses the FINCH subroutine to bring 
the requested routine into the dynamic 
area. If the requested routine is "only 
loadable, " ATTACH issues an ABEND macro 
instruction to abnormally terminate the 
task. Otherwise, ATTACH alters its resume 
PSW, so that after branching to the Dis- 
patcher control will return to that portion 
of the ATTACH routine which passes control 
to the attached routine (entry point 
IEAOAT01) . ATTACH then branches to the 
Dispatcher to dispatch any asynchronous 
routines that may have been scheduled while 
FINCH was executing. 

If the RB of the requested routine is 
found when searching the loaded program 
list, ATTACH routine determines if the 
requested routine is "only loadable." If 
so, ATTACH issues an ABEND macro instruc- 
tion to abnormally terminate the task. If 
it is not "only loadable", ATTACH deter- 
mines if the RB is active. If the RB is 
not active, ATTACH can use the routine that 
is already in the dynamic area. The ATTACH 
routine branches to that portion of ATTACH 
which passes control to the routine to be 
attached (below). If the RB of the 
requested routine is an active RB on the 
loaded program list, the ATTACH routine 
determines if the RB is a minor LPRB (see 
Section 2 for a definition of minor RBs) . 
If it is not a minor LPRB, ATTACH searches 
the resident reenterable module area. If 
it is a minor LPRB, the ATTACH routine 
issues a GETMAIN macro instruction to get 
32 bytes of main storage for a PRB. ATTACH 
then initializes this RB and branches to 
the portion of ATTACH which passes control 
to the routine to be attached. 

If a usable copy of the module has been 
found, or was loaded by FINCH, the ATTACH 
routine places the RB for the attached rou- 
tine on the active RB queue, zeros the wait 
count, and sets the active bit in the RB 
for the attached routine. ATTACH issues a 
GETMAIN macro instruction to get 72 bytes 
of main storage to be used as a save area 
by the attached routine. ATTACH alters its 
SVRB resume PSW so that after branching to 
the Dispatcher to pass control to the 
attached routine, it will regain control 
(from the dispatcher when the attached rou- 
tine completes executing) at the point 



where it determines if an event control 
block (ECB) is to be posted (entry point 
IEA0AT02). 

ATTACH builds, at location 8, the PSW 
which will be loaded to pass control to the 
attached routine, and loads register 14 
with the address of an SVC 3 instruction to 
be executed when the attached routine com- 
pletes execution. ATTACH then loads the 
PSW built at location 8, passing control to 
the attached routine. 

Upon completion of the attached routine, 
ATTACH determines if the attaching routine 
specified an ECB to be posted. If an ECB 
is to be posted, ATTACH determines if the 
ECB "complete" bit is already set. If it 
is not set, ATTACH posts the ECB by setting 
the "wait" bit off and the "complete" bit 
on, and then frees the 72 byte save area 
which was used by the attached routine. If 
the "complete" bit is already set, or if an 
ECB is not to be posted, ATTACH only frees 
the 72 -byte save area. 

If the attaching routine specified an 
exit routine to receive control after com- 
pletion of the attached routine (in the 
ETXR parameter of the ATTACH macro instruc- 
tion) , ATTACH issues a GETMAIN macro 
instruction to get main storage for an IRB 
and a 72-byte save area. ATTACH then ini- 
tializes the IRB and places it on the 
active RB queue between the ATTACH SVRB and 
the RB of the attaching routine. ATTACH 
then issues an SVC 3 instruction to pass 
control to EXIT. If an exit routine was 
not specified by the attaching routine, 
ATTACH issues an SVC 3 instruction to pass 
control immediately to EXIT and eventually 
to the attaching routine. 



DELETE (IEAADLOO) CHART EF 

If the specified module name is IGC019xx 
and DELETE finds the module on the list of 
Resident Access Method modules (RAM list) , 
DELETE returns control to the caller. 

DELETE next searches the load list and 
the job pack area queue (JPAQ) for a loaded 
request block (LRB/LPRB) containing the 
specified entry- point name. If such an 
LRB/LPRB is not found, the routine sets up 
a return code (4) and returns control to 
the caller. DELETE obtains the load-list 
origin from the TCBLLS field of the current 
TCB and the JPAQ origin in the PIB. 
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If the specified entry-point name is 
found, DELETE subtracts one from the "use" 
count (XRBUSE) in the request block for the 
specified module. This count is a record 
of the number of outstanding load requests 
for the module. Each execution of DELETE 
will similarly decrease the use count until 
the count reaches 0. A use count of 
indicates that there are no outstanding 
load requests; that is, there have been as 
many delete requests for the module as 
there have been load requests. If the use 
count in the request block is f the rou- 
tine removes the element from the loaded 
program list, and issues a FREEMAIN macro 
instruction to free the main storage occu- 
pied by the module and its RBs Cboth major 
and minor RBs, if both types exist). After 
freeing the module's main storage, DELETE 
returns control to the caller with a return 
code of . 



If the count is not 0, at least one 
requesting program within the current task 
has not completed its use of the module. 
That is, the program has not yet issued a 
RETURN macro instruction, nor has a DELETE 
macro instruction been issued for it. 
Since the module's main-storage areas can- 
not be freed, the routine returns control 
to the caller. 



LOAD (IEAATC00) CHART EB 

LOAD searches the queues of the job pack 
area (MFT with subtasking only) , the resi- 
dent access method area (optional) , the 
loaded program list, and the resident 
reenterable module area (optional) for the 
request block of the requested module. The 
following table summarizes the possible 
conditions and the resulting actions taken 
for each. 



"T" 

I 



Condition 



Action 



1. *RB found on JPAQ and Minor LPRB 
on load list 



Issue SVC 13 to abnormally terminate the task 



2. *LRB or LPRB found on JPAQ 



Go to action 13 



3. * 



I L 
I— 



Create FRB and place on top of JPAQ 



U. RB found on RAM list 



Go to action 12 (skip action 13) 



5. RB found on load list 



Dequeue FRB, remove all WLE SVRBs from wait 
state 



6. Minor LPRB found on load list 



j. 

7. LRB or LPRB found on load list 



Issue SVC 13 to abnormally terminate the task 



Go to action 12 



8. *RB found on resident reenterable 
module area 
+ 



Create dummy LPRB and place it on JPAQ or load 
list. Go to action 12 



9. 



H- 



10. *Module loaded by FINCH is 
reenterable 



Use FINCH to bring the module into main storage 
Queue RB on JPAQ. Go to action 12 






-H 



n. 
I- 

12. 

13. 

I 

14. 
(. 

15. 



-+ 



Queue RB on Load List 



Dequeue FRB; remove all WLE SVRBs from wait 
state 



Increment use count in RB 

Load entry point address into register 

Issue SVC 3 



*MFT with subtasking only 
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LINK (IEAATCOO) CHART EB 

LINK searches the job pack area queue 
(MFT with subtasking only), the loaded pro- 
gram list, and the resident reenterable 
module area for the request block of the 
requested routine. If the module is repre- 
sented by a FINCH request block (FRB) on 
the job pack area queue, indicating that 
the module is currently being loaded as a 
result of a previous request, LINK queues a 
wait list element (WLE) for this request to 
the FRB, indicates that a task switch is 
necessary by setting NEW to 0, sets the 
resume PSW in the SVRB for LINK to reenter 
LINK, and branches to the Dispatcher. 

If the module is represented on the job 
pack area queue or the loaded program list 
by a dummy LPRB, indicating that the module 
was found in the resident reenterable 
module area by a previous load request, or 
if the module is found in the resident 
reenterable module area, LINK creates a 
dummy LPRB for this request. 

If the module is not found, LINK uses 
FINCH to bring a copy of the module into 
the partition. When an accessible copy of 
the module exists in main storage, LINK 
determines if entry was caused by a dummy 
PRB created by the subtasking ATTACH rou- 
tine (IEAQAT00). If so, the dummy PRB is 
dequeued from the subtask TCB and its area 
is freed. 

If the accessible module is represented 
by an LRB, or by a minor LPRB and this is 
not processing as a result of an SVC 6 
instruction being executed for the subtask- 
ing ATTACH routine, LINK issues an SVC 13 
to abnormally terminate the task. 

If a copy is available for use, LINK 
initializes the request block for the 
module and places it on the TCE RB queue 
following the SVRB for LINK. If the XCTL 
option has been specified in a STAE macro 
instruction issued by the program that 
issued the LINK macro instruction, the RB 
address fields in the STAE control blocks 
are updated to reflect the address of the 
new request block. LINK terminates pro- 
cessing by issuing an SVC 3 instruction 
(EXIT) . 



XCTL (IEAATCOO) CHART EB 

If the calling routine is a type 3 or 4 
SVC routine, XCTL either finds the module 
in the resident SVC area (optional) or uses 
FINCH to bring the module into the SVC 
transient area. XCTL then branches to that 
part of LINK that initializes the request 
block, places it on the RB queue and exits. 



If the XCTL was issued by a type 2 SVC 
routine , or by a routine represented by an 
IRB or an SIRB, XCTL issues an SVC 13 to 
abnormally terminate the task. 

If the request was not from a type 3 or 
4 SVC routine, XCTL removes the caller's 
request block from the RB queue. If the 
calling routine was not brought into main 
storage by LOAD, the main storage for the 
routine and its request block is freed. 

XCTL then searches the queues of the job 
pack area, the loaded program area, and the 
resident reenterable module area. The 
search of these queues by XCTL, the loading 
by FINCH when the module is not found, and 
the final processing of the request block 
is the same as that done by LINK, except 
that XCTL does no processing for ATTACH. 



FINCH (IEAATCOO) CHARTS EC AND ED 

The FINCH subroutine is entered by a 
branch and link instruction from the fol- 
lowing entry sources to cause the loading 
of a specified module: 

• ATTACH 

• LINK 

• LOAD 

• XCTL from a user program. 

• XCTL from a routine in the SVC tran- 
sient area. 

• XCTL from a routine in the I/O error 
transient area. 

• SVC SLIH loading the SVC transient 
area. 

• Dispatcher refreshing the SVC transient 
area. 

• LOAD from the SVC library. 

FINCH consists of initialization 
instructions and several sections of code. 
These sections are either executed or 
bypassed, depending upon the routine which 
branched to FINCH. Thus, there are eight 
different combinations of instructions 
executed (requests from LINK and XCTL are 
processed identically) depending upon the 
source of the request. Each section of 
code is immediately preceded by a BXLE 
instruction and a comment card that indi- 
cates which requests will be processed by 
that section of code. 

Each branch and link instruction to 
FINCH is followed in the requesting routine 
by a one-byte identifier used to access one 
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of the nine halfword constants within 
FINCH, The bit pattern of each halfword is 
used by BXLE instructions within FINCH to 
determine which sections of code will be 
executed for each request. 

With the appropriate halfword constant 
in the high-order position of register JBR f 
the format of the BXLE instruction is: 



Figure 37 gives a more detailed descrip- 
tion of the processing involved. The left 
column is the label for the first instruc- 
tion executed for that section of code. 
The center column indicates the source of 
the FINCH request for which this code will 
be executed. The right column describes 
the processing done within that section of 
code. 



BXLE JBR,JBR,addr 

where addr is the label of another instruc- 
tion, or an address relative to the address 
of the BXLE instruction (i.e., *+4, *+8, 
etc. ) ; this is the address used when the 
branch is taken. 

The result of the BXLE instruction is 
effectively a shift left single (which sets 
a condition code) and a branch on condition 
4. If the high-order bit in the register 
after the shift left single is 1, the 
branch will be taken. If the high-order 
bit is f the branch will not be taken. 
Figure 36 illustrates the BXLE instruction 
as used in a program that has three entry 
sources. 

Generally, FINCH uses the data manage- 
ment BLDL routine to locate a named routine 
on an external storage device. Using the 
information provided by BLDL, FINCH ini- 
tializes the Program Fetch parameters and 
uses the Program Fetch routine to bring the 
specified routine into main storage. FINCH 
processes the necessary RBs when issuing 
GETMAIN, and initializes them with the RB 
type and size of the storage space they and 
their routines occupy. 



ENTER 


EQU 


* 


INITIALIZE BITS FOR BXLE 


* ALL 


(PROGA, PROGB, PROGC) 






LH 


JBR # (JRETRN) 


GET IDENTIFIER FROM CALLER 




LH 


JBR, BITTAB (JBR) 


LOAD HALFWORD BIT PATTERN 




SLL 


JBR, 16 


MOVE BIT PATTERN TO HIGH ORDER 




BXLE 


JBR,JBR,SECT2 
*, PROGA, PROGB 


SECT2 FOR PROGC 


SECT1 


* 








BXLE 


JBR,JBR,SECT3 
*, PROGA, PROGC 


SECT3 FOR PROGB 


SECT2 


• 








BXLE 


JBR,JBR,0UT4 
*, PROGB, PROGC 


OUT4 FOR PROGA 


SECT3 


• 








BXLE 


JBR , JBR , 2 (JRETRN) 
*, PROGA, PROGB 


RETURN FOR PROGC 


OUT 4 


• 








BC 


15,2 (JRETRN) 


RETURN FOR PROGA AND PROGB 


BITTAB 


EQU 


* 


INDEXED BY CALLER INDENTIFIER 






*, PROGA USES BIT PATTERN 0001 0000 0000 0000 






*, WHICH IS D f 4 096' 


' OR X , 1000 t 




DC 


H* 4096* 


PROG A 






*, PROGB USES BIT PATTERN 0010 0000 0000 0000 






*, WHICH IS D , 8192' 


1 OR X^OOO* 




DC 


H'8192' 


PROG B 






*, PROGC USES BIT PATTERN 0101 0000 0000 0000 






*, WHICH IS D , 20480 t or X'5000' 




DC 


H" 20480' 




JBR 


EQU 


9 




JRETRN 


EQU 


14 




Figui 


:e 36. BXLE Instruction 



IDENTIFY (IEAAID00) CHART DE 

IDENTIFY determines if the identified 
entry point is within the boundaries of the 
routine that issued the IDENTIFY macro 
instruction, or within the boundaries of a 
routine represented on the job pack area 
queue (with subtasking only) or on the 
loaded program list. If the identified 
entry point address is not within the 
correct boundaries, IDENTIFY places a 
return code of 12 (decimal) in register 15 
and issues an SVC 3 (EXIT) instruction. 

If the entry point address is within the 
correct boundaries, IDENTIFY checks the RB 
(field XSTAB) of the routine that contains 
the identified entry point to determine if 
that RB is a PRB or an LPRB. If it is not, 
IDENTIFY places a return code of 16 (decim- 
al) in register 15 and issues an SVC 3 
(EXIT) instruction. 

If the RB of the routine that contains 
the entry point address is a PRB or an 
LPRB, IDENTIFY determines if the name of 
the entry point is a duplicate of any RB 
program name (RB field XRBNM) already on 
the loaded program list, JPAQ, or TCB RB 
Queue. If it is, IDENTIFY places a return 
code of 4 (duplicate address in minor LPRB) 
20 (duplicate name in minor LPRB) , or 8 
(duplicate name found in other than minor 
LPRB) in register 15 and issues an SVC 3 
(EXIT) instruction. If it is not, IDENTIFY 
obtains main storage for a minor LPRB and 
initializes the minor LPRB on a chain of 
minor LPRBs attached to the major RB (see 
Figure 38). IDENTIFY then places a return 
code of in register 15 and issues an SVC 
3 (EXIT) instruction. 



SYNCH (IEAASY00) 



SYNCH first issues a GETMAIN for a 32- 
byte request block in lower storage. SYNCH 
then queues this RB on the RB queue below 
the SVRB for SYNCH. SYNCH initializes the 
PSW location in the RB (RBPSW) to address 
the location specified in register 15 upon 
entry to SYNCH. (The PSW is set in problem 
state with the task protection key recorded 
in the TCB.) SYNCH exits via an SVC 3 
instruction. 
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Label or 
Instruction 



Source of Request 



Operation 



H 



IEA0FN00 



Entry point for the 
ATTACH, SVC SLIH, and 
Dispatcher Entry for XCTL 
from I/O error transient 
area 



If an error routine is requested and is 
found in the I/O error transient area 
or is represented on the error recovery 
procedure load list (IEAAERP) , the 
entry point address in the resume PSW 
in the SIRB is reset to point to the 
error routine. FINCH issues an SVC 3 
(EXIT) instruction. 



H 



XFINCH 



All 

Entry for XCTL r XCTL from 

SVC transient area, LINK, 

LOAD, LOAD from SVC 

library 



FINCH identifies the caller via entry 
code. BXLE register is loaded with 
bit pattern. 



MMLABEL 



LOAD 



FINCH indicates that main storage in 
the low area of the partition is to be 
obtained. 



IEAARAMO 



All except LOAD from SVC 
library 



A GETMAIN macro instruction is issued 
for Program Fetch work area. 



XF1 



H- 



XFINCHl 



Load from SVC library, 
XCTL from SVC or I/O error 
transient area, SVC SLIH 
loading SVC transient 
area. Dispatcher refresh- 
ing the SVC transient 
area (if GETMAIN failed) 



The PANIC is used as a work area for 
Program Fetch. This happens only if 
GETMAIN failed to obtain work area. 
Load from SVC library always uses the 
PANIC. 



All 



If LCS is in the system, the scatter 
table list is cleared. FINCH initial- 
izes the BLDL address in the FINCH 
parameter list. 



(no label) 



XF2 



XF12 



ATTACH, LINK, LOAD, XCTL 
from SVC transient area, 
and LOAD from SVC library 



Registers and 1 are initialized with 
pointers to name of desired program or 
pointers to BLDL. The name of program 
in register and the address of the 
DCB to be initialized goes in register 
1. Move BLDL list, if provided to 
work area. 



XCTL from I/O error 
transient area, SVC SLIH, 
Dispatcher 



FINCH initializes BLDL parameters. 



All except Dispatcher 
refilling transient area 
(BLDL list is not 
provided) 



FINCH finishes BLDL initialization and 
links to data management BLDL routine 
to locate the requested module on aux- 
iliary storage. (This information is 
already available to EXIT.) 



XFINCH2 



ATTACH, LINK, LOAD, XCTL, 
and LOAD from SVC library 



Information obtained from BLDL 
operation is tested. Determination is 
made of status of program. 



Figure 37. FINCH Processing (Part 1 of 4) 
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Label or 
Instruction 



Source of Request 



Operation 



LRBCMPD 



ATTACH, LINK, LOAD, XCTL, 
LOAD from SVC library 



FINCH determines the size of the 
requested program and its RB prior to 
obtaining storage space for the rou- 
tine. This information is obtained 
from BLDL list. If the requested 
module is an overlay module, space for 
a note-list is needed. 



LOAD, LOAD from SVC 
library 



XF5 (LCS Only) 

XFLCS1 

XFLCS2 



ATTACH, LINK, LOAD, XCTL, 
LOAD from SVC library 



--+■ 



Indicates storage to be obtained from 
high area of partition. 



h" 



If the system has the LCS Option, 
FINCH clears the scatter translation 
table. FINCH then checks whether 
hierarchy or 1 is requested, and 
prepares GETMAIN parameter. FINCH 
checks if program is to be scatter 
loaded and hierarchy was not indi- 
cated. If program is not to be scatt- 
er loaded, FINCH sets GETMAIN paramet- 
er to indicate HO. 



H 



XFLCS3 



ATTACH, LINK, LOAD, XCTL, 
LOAD from SVC library 



I— 



If a job pack area queue does not exist 
for this partition, a REGMAIN is 
issued to get storage for its RB. 



H 



PIBON, SAVEDATA 
YESRENT 



LOAD, LOAD from SVC 
library (job pack area 
queue exists) 



I— 



Since the FRB built by the last load 
request (the request now in FINCH) is 
queued first, FINCH obtains the 
address of the current FRB from the 
PIB. FINCH, upon determining that the 
module to be fetched is reenterable, 
prepares to obtain RB storage from 
subpool 240. FINCH adjusts the FRB to 
indicate reenterability. 



ENDFNI 
LEAVE JX 



ATTACH, LINK, XCTL, LOAD, 
LOAD from SVC library (job 
pack area queue exists) 



If module is not reenterable, FINCH 
adjusts FRB to reflect this status. 
FINCH issues a register-form GETMAIN 
macro instruction for the program and 
its RB. 



-H 



ENDFN2 
XFLCS4 



ATTACH, LINK, XCTL, LOAD, 
LOAD from SVC library 



FINCH then initializes RB and checks 
for LRB and validity checking. 



XFSCHED 



ATTACH, LINK, LOAD, XCTL, 
LOAD from SVC library 



FINCH inserts either job library or 
link library DCB address in Program 
Fetch parameter list if request 
entered with a in DCB address field. 



-H 



XF10 



XF4 



Dispatcher 
+ 



Initializes Program Fetch parameter 
list. 



Transient area routines 
(XCTL from SVC transient 
area, XCTL from error 
transient area, SVC SLIH, 
Dispatcher) 



+— 



FINCH initialized the Fetch parameter 
list (inserts TTR, STAB, SVCDCB 
address, etc.) 



Figure 37. FINCH Processing (Part 2 of 4) 
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Label or 
Instruction 



Source of Request 



Operation 



H 



XSNTQUES 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



If this request is from time slice task 
and the previous request was also from 
a time slice task which is still dis- 
patchable, FINCH does not allow this 
request to preempt the previous requ- 
est for the transient area. If the 
requested module is already in the 
transient area, FINCH branches to 
XSNTEXIT. 



H 



QAVBLE 



QUEREG 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



If the transient area is not currently 
being loaded, the address of the TCB 
for the transient area loading task is 
placed in NEW, and the SVRB for the 
task is set dispatchable. 
The boundary box for the requesting 
task is placed on the transient area 
request queue, the address of the SVRB 
for the request is placed in the boun- 
dary box, and the SVRB is put in a 
wait state. 



TMSLCEXT 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



The resume PSW in the SVRB is set to 
the address of XSNTQUE to allow repro- 
cessing if this request is not handled 
at this time. 



DISPEXIT 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



If transient area is currently being 
loaded, sets NEW to 0. For either 
case, FINCH branches to the dispatcher 
to give control to the transient area 
loading task. 



IEAFNCH 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



XF6 



All 



h» 



The resume PSW in the transient area 
loading task f s SVRB points to the 
label IEAFNCH. This code (through 
DEQEND) is executed under the TCB and 
SVRB for the transient area loading 
task. The address of the TCB is 
loaded into register 4 for Program 
Fetch, and the system is disabled for 
interruptions . 

FINCH branches and links to Program 
Fetch (IEWMSEPT) which brings the 
requested module into main storage. 



(no label) 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



If an error occurred in Program Fetch 
FINCH retries to load the module by 
branching to XF6 (maximum retries = 
4). 



DDRINTF 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



If the error persisted in Program 
Fetch, FINCH branches to the Dynamic 
Device Reconfiguration support so that 
the system residence device may be 
changed. FINCH then branches to XF6 
to retry the loading. 



Figure 37. FINCH Processing (Part 3 of 4) 
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Label or 
Instruction 



Source of Request 



Operation 



REC0VER1 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



If the error occurs on the new device, 
FINCH branches and links to ABTERM to 
schedule abnormal termination of the 
task. Return is to ERROR. 



NOERROR 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



If the requesting task is time-sliced, 
the pointers to the TCB and the SVRB 
are saved so that it will not be 
preempted. 



-H 



ERROR 
NOTTMSLC 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



The switch indicating that the trans- 
ient area is currently being loaded is 
set off. The transient area queue is 
freed, and any SVRBs on it are removed 
from the wait state. 



DEQEND 



XSNTEXIT 

(Branched to from 
XSNTQUES when 
requested module 
is in SVC tran- 
sient area) 



XCTL from SVC transient 
area, SVC SLIH, Dispatcher 

XCTL from SVC transient 
area, SVC SLIH, Dispatcher 



The transient area loading task is re- 
initialized. FINCH branches to DISPE- 
XIT (above). 

The SVRB for the requested module is 
initialized and the work area is freed. 
FINCH returns to the caller. 



XF8 



ATTACH, LINK, LOAD, XCTL 
from I/O error transient 
area, LOAD from SVC 
library 



XF14 



+ 



If an error occurred during Program 
Fetch, the task is abnormally termi- 
nated. If the Automatic System Recov- 
ery option is in the system, and the 
loaded module is refreshable, the 
refreshable bit is initialized in the 
loaded module" s RB. FINCH enables 
callers that were pseudo-disabled. If 
the program is being tested, FINCH 
passes control to the TESTRAN inter- 
preter. If the requested routine is 
an overlay program, FINCH issues a 
LOAD macro instruction to bring over- 
lay supervisor 2 into the system (see 
"Overlay Supervisor"). 



I- 

XF13 



ATTACH, LINK, LOAD, XCTL, 
LOAD from SVC library 



FINCH returns to the calling routine. 



XCTL from I/O error 
transient area 



FINCH loads the address of the error 
transient area into register 15 and 
disables the PSW in the SIRB. FINCH 
branches and links to the calling rou- 
tine. Upon return, FINCH issues an 
SVC 3 (EXIT) instruction. 



Figure 37. FINCH Processing (Part 4 of 4) 
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TCB 



RB of routine which contains identified entry point. 

May be latest RB on Active RB Queue (excluding SVRB for IDENTIFY 

routine), or any RB on Loaded Program List. 

XSTAB - indicates a "Major" RB 



C 



TCBLLS 



"Major" 
RB 









XSTAB 






XRBQ 





"Minor" 
LPRB 



XRBSUC 



XRBPRE 



XSTAB 



XRBQ 



From next RB on Loaded 
Program List (if any) 

To next RB on Loaded 
Program List or, if no 
other RB exists on List, 
contains 0. 



XSTAB - indicates "Minor" LPRB 

XRBQ - contains address of previously built "Minor" 
LPRB or, if no previous "Minor" LPRB exists, 
contains 0. 



Figure 38. Queueing a Minor LPRB FOR Identify 
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MAIN STORAGE SUPERVISION ROUTINES 



GETMAIN (IEAAMS) CHART FA 

Both the GETMAIN and FREEMAIN macro 
instructions may be written in two forms, S 
(storage type) and R (register type). S- 
type macro instruction supplies parameters 
in a parameter list; an R-type supplies 
parameters in the general registers. 

For a S-type request, the GETMAIN rou- 
tine determines whether it is a list re- 
quest (a request for more than one area of 
main storage) . In the event of a list re- 
quest, GETMAIN passes control to ABTERM to 
schedule abnormal termination of the task, 
since list requests are not valid in MFT 
systems. 

GETMAIN then tests the subpool numbers. 
All valid main storage requests from prob- 
lem programs are allocated from the highest 
available main storage in the partition, 
regardless of the subpool number specified 
in the GETMAIN macro instruction. For 
problem programs, only subpool numbers 
through 127 are considered valid. All 
others cause abnormal termination of the 
requester. 

When a system task issues a GETMAIN 
macro instruction specifying subpools 
through 127, storage is allocated from the 
low-address portion of the partition; when 
the macro instruction specifies a subpool 
from 128 through 244 or 246 through 254, 
storage is allocated from the high-address 
portion of the partition. Subpools 245 and 
255 get storage from the system queue area 
(SQA). 

GETMAIN indicates whether the request is 
to be satisfied from the high- or low- end 
of the partition. The free area queue is 
then searched, beginning with the free area 
queue element (FQE) that has the highest 
address in the partition. GETMAIN compares 
the size of the request to the size of the 
free area indicated by that FQE. If the 
request is larger than the free area, the 
next FQE is checked. As GETMAIN checks 
each FQE, it keeps a record of the largest 
free area found. When a free area equal to 
or larger than the requested size is found, 
GETMAIN allocates the requested main 
storage from the high end of this free 
area. 

If the request is for space in the low- 
end of the partition, GETMAIN saves the 
address of the first free area of suffi- 
cient size and searches the free area 
queue. As each FQE is examined, the 



address of the lowest free area of suffi- 
cient size to fulfill the request is always 
saved. When all FQEs have been checked, 
the requested main storage is allocated 
from the low end of the lowest free area 
that is large enough. 

If an area large enough to satisfy an 
R-type or an unconditional S-type request 
is not found, or if a request was made for 
zero bytes of storage, GETMAIN identifies 
the caller. If either ABEND or the SVC 
SLIH issued the request, an error code is 
placed in register 15, and control is 
returned to the caller. This eliminates 
the possibility of entering a loop caused 
by rescheduling an abnormal termination. 
If any other task issued the GETMAIN macro 
instruction, control is passed to ABTERM to 
schedule abnormal termination of the 
caller. 

If an area large enough to satisfy a 
conditional S-type request (both variable 
and nonvariable) is not found, GETMAIN 
places a return code of 4 in register 15 
and returns control to the caller. 

When GETMAIN allocates main storage, the 
address of the allocated space is returned 
to the caller in register 1 for R-type 
requests, or in the area indicated by the 
pointer in the parameter list for S-type 
requests. If the request is for a variable 
amount of space, the size of the allocated 
space is also returned in the area indi- 
cated by the parameter list. 

GETMAIN places a return code of in 
register 15 (indicating that the request 
was satisfied) , removes the newly allocated 
space from the free area queue or modifies 
the FQE if the whole space was not allo- 
cated, and branches to the Type-1 SVC Exit 
routine to return control to the caller. 

If SMF is in the system, the GETMAIN 
routine also passes control to its SMF 
storage information subroutine (GMSMFCRE) . 
It tests the TCBTCT field of the TCB for 
the address of a Timing Control Table 
(TCT). If this field contains 0"s, there 
is no TCT and storage usage information 
cannot be recorded. If the TCBTCT field 
contains a TCT address, the subroutine 
determines whether the newly allocated 
storage alters either the low- water mark 
(LWM) or the high-water mark (HWM) . (The 
LWM is the value of the highest storage 
address allocated from the bottom of the 
partition. The HWM is the value of the 
lowest storage address allocated from the 
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top of the partition.) If either is 
altered, the SMF subroutine stores the new 
value in the appropriate TCT field (TCTLWM 
or TCTHWM) . 

It also calculates the all-time minimum 
difference, in terms of 2 04 8- byte blocks, 
between the LWM and the HWM. If the new 
allocation creates a new minimum dif- 
ference, the SMF storage subroutine records 
the new difference in the TCTMINC field of 
the TCT. It then returns control to 
GETMAIN. 

In MFT systems with subtasking, main 
storage supervision processing differs from 
systems without subtasking as follows: 

• The supervisor builds a queue of gotten 
subtask area queue elements (GQEs) to 
describe the main storage obtained by 
system-issued GETMAIN macro instruc- 
tions for a subtask unless the request 
specified subpool 240. The first GQE 
associated with a subtask originates in 
the TCBMSS field of the subtask 1 s TCB. 
Succeeding GQEs are built in the first 
eight bytes of main storage acquired 
for a subtask. 

• When a subtask terminates, the normal 
or abnormal termination routines refer 
to the GQEs chained to the subtask 1 s 
TCB to free the main storage belonging 
to the terminating subtask. The GQEs 
are removed from the queue whenever the 
subtask' s main storage is freed. 



FREEMAIN (IEAAMS) CHART FA 

When main storage is to be released, 
FREEMAIN is entered either at entry point 
IGC005 for S-type requests or at entry 
point IGC010 for R-type requests. 

If any of the following errors is dis- 
covered , FREEMAIN passes control to ABTERM 
to schedule abnormal termination of the 
task: 



• The request is an S-type list request 
(valid only in MVT) . 



The area to be freed does not begin on 
a doubleword boundary. 



• The area to be freed overlaps an exist- 
ing free area. 



• The area to be freed is not totally 
contained in the task's partition. 



If none of these errors exists, FREEMAIN 
makes the space being freed available for 
reallocation. This is done either by 
updating the FQE of an adjacent free area 
or, if there is no adjacent free area, by 
creating an FQE and adding it to the free 
area queue. If a GQE is associated with 
and describes the entire area to be freed, 
the GQE is freed also. 

If SMF is in the system, FREEMAIN passes 
control to its SMF storage information sub- 
routine (FMSMFCRE) . The subroutine first 
tests the TCBTCT field of the TCB for the 
address of a TCT. If there is no TCT, 
storage-usage information cannot be reco- 
rded. If the TCBTCT field contains a TCT 
address, the subroutine determines whether 
the newly released storage causes a change 
in the low-water mark (LWM) or the high- 
water mark (HWM) for the partition. (The 
LWM is the value of the highest storage 
address allocated from the bottom of the 
partition, and the HWM is the value of the 
lowest storage address allocated from the 
top of the partition.) If either is 
changed, the SMF storage subroutine stores 
the new value in the appropriate TCT field 
(TCTLWM or TCTHWM) and returns control to 
FREEMAIN. 

FREEMAIN then branches to the Type-1 SVC 
Exit routine to return control to the 
caller. 
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COMMUNICATION TASK ROUTINES 



In the description below, the modules 
that support the communication task with 
Multiple Console Support (MCS) follow the 
non-MCS communication task modules. The 
Initialization (IEECVCTI), External Inter- 
ruption Handler (IEECVCRX) , Attention 
Handler (IEECVCRA) , and the Unit Control 
(IEECVUCM) modules are common to both MCS 
and non-MCS communication tasks. See Dia- 
grams 14 and 15. 



INITIALIZATION MODULE (IEECVCTI) CHART GA 

The Initialization module is entered 
from the Master Scheduler. If MCS is 
included in the system and the hard copy 
log is a console, IEECVCTI posts the NIP 
message buffer ECB in the UCM so that NIP 
messages will be written by the module 
IEECMWTL. The Initialization module then 
searches the UCM f changing the UCB name of 
each device to an address. If an address 
cannot be determined , a message is issued 
to the master console and the search con- 
tinues. For each UCB name that is correct- 
ly matched with an address, a message is 
written to the console advising the opera- 
tor of its unit address , its alternate's 
address, its console identification number, 
its display area configuration, its command 
code and routing code authorization, its 
status (active or inactive), and whether it 
is the master console, a secondary console, 
or the hard copy log. The Initialization 
module then builds an event indication list 
(EIL) , which contains the addresses of the 
attention, external, WTO, and I/O ECBs for 
the consoles initialized. For MCS, the EIL 
will also contain the addresses of the DOM 
ECBS. 

If the system includes display consoles, 
control is passed to the Graphic Console 
Initialization module (IEECVGCI) . Upon 
return from IEECVGCI, control returns to 
the Master Scheduler IPL routine. 



GRAPHIC CONSOLE INITIALIZATION (IEECVGCI) 
CHART GY 

The Graphic Console Initialization 
module is entered from the Console Initia- 
lization Module when that routine deter- 
mines that console initialization is 
required for one or more display consoles. 
IEECVGCI first searches for a UCM repre- 
senting a display console. If none are 
found, control is returned to the Console 
Initialization routine. If one is found, 
the routine issues a LOCATE macro instruc- 



tion to search for SYS1.DCMLIB, and, if 
found, issues an OPEN macro instruction to 
open SYS1.DCMLIB. If either the LOCATE or 
the OPEN fail, an error message is written 
to the operator's console and one console 
in each transient group is made resident 
(the console whose TDCM was initially 
placed in the transient area). If SYS1. 
DCMLIB is successfully opened, IEECVGCI 
attempts to read a copy of the PFK defini- 
tions for each console into main storage. 
If the read is unsuccessful, a message is 
issued to the operator. When all display 
consoles in the system have been initia- 
lized, control is returned to the Console 
Initialization module. 



WRITE TO OPERATOR MODULE (IEEMFWTO, 
IEENFWTO) CHART GC 

This module is entered as a result of an 
SVC 35 instruction issued from a WTO or 
WTOR macro instruction. IEEMFWTO handles 
processing for MCS systems; IEENFWTO 
handles processing for non-MCS systems. If 
entered for a WTOR or WTP request, control 
is passed to the Write to Programmer module 
IEEWTPOO or the WTOR module IEEVWTOR 
respectively. 

If entry is for a multiple-line WTO, 
control is passed to either the Non-MCS 
MLWTO routine (IEECVML1), or to the MCS 
MLWTO routine (IEECVML3) as appropriate. 
Upon return from either of these two 
modules or if this is a WTO request, IEEMF- 
WTO or IEENFWTO edits the message, moves 
the text into an available Write Queue Ele- 
ment (WQE) , and puts the WQE on the system 
output queue that originates in the UCM. 

If a WQE is not available and the com- 
munication task is issuing the WTO(R), 
entry is from DAR or System Log, or entry 
is from the system error task, IEEMFWTO or 
IEENFWTO issues a GETMAIN macro instruction 
to obtain main storage for a WQE. For 
other cases when a WQE is not available, 
IEEMFWTO or IEENFWTO issues an ENQ macro 
instruction to gain exclusive access to a 
buffer. Upon return from ENQ, if a WQE is 
still not available, a WAIT macro instruc- 
tion is issued specifying the WQE message 
buffer request ECB in the UCM. When a WQE 
becomes available, processing resumes with 
message editing (above). 

When the WQE has been placed on the sys- 
tem output queue, IEEMFWTO or IEENFWTO 
posts the WTO ECB in the UCM and branches 
to the EXIT routine. If MCS is in the sys- 
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tern, the WQE ID number is placed in the 
WQE, and MCS routing codes, descriptor 
codes , and flags are moved into the WQE 
before the WTO ECB is posted. 



NON-MCS MULTIPLE-LINE WRITE TO OPERATOR 
(IEECVML1, IEECVML2, IEECVMHO CHART GD 

IEECVML1 is entered from IEENFWTO to 
process requests for multiple-line WTOs in 
a system without MCS. This routine builds 
the major WQE for the multiple-line WTO. 
Upon initial entry , the routine checks to 
see if entry has been made to add addition- 
al lines to an existing WTO. If so, the 
major WQE has already been built f so con- 
trol is passed to IEECVML2. 

If IEECVML1 is entered to build a major 
WQE, the first line passed is checked to 
see that it is within the user's core. 
Also, the number of lines passed is deter- 
mined. If the number is zero or less, the 
line number field in the WQE is set to 1. 
If the number of lines passed is greater 
than 10 for a problem program, the number 
will be set to 10; if the number is greater 
than 255 for a supervisor mode or protect 
key program, the number will be set to 1. 

If no error conditions are found, the 
routine attempts to obtain buffer space for 
the major WQE. If space is not available, 
and the routine issuing the request is the 
communications task, DAR, or an SIRB, buff- 
er space in main storage is immediately 
obtained by means of the GETMAIN macro. 
Otherwise, the routine issues an ENQ macro 
and a WAIT macro (specifying the WQE mes- 
sage buffer request ECB in the UCM) . When 
a buffer becomes available, it is allocated 
from fixed buffer space. 

When the buffer has been obtained, the 
text fields are filled in, and exit is then 
made to IEECVML4. 

IEECVML4 completes building of the major 
WQE. Upon entry, this routine stores the 
MLWTO identification number and partition 
identifier in the appropriate areas of the 
major WQE. If there are minor WQEs to be 
built, exit is made to IEECVML2. Other- 
wise, the WTO ECB in the UCM is posted and 
exit is made to the calling routine. 

If additional lines are to be added to 
an existing WTO (requiring minor WQEs) , 
control is passed to IEECVML2. Upon entry, 
this routine checks for available buffer 
space for the minor WQE. 

If none is available, and the routine is 
the communications task, DAR or an SIRB, a 
GETMAIN macro is issued immediately for the 
required main storage. Otherwise, the rou- 
tine issues an ENQ and a WAIT macro (speci- 



fying the WQE buffer request ECB in the 
UCM) . When a buffer is obtained, the text 
fields are filled in. If more lines remain 
to be output, processing continues. When 
the end line is reached (all lines having 
been placed on the system output queue) , 
the routine posts the WTO ECB and exits to 
the calling routine. 



MCS MULTIPLE-LINE WRITE TO OPERATOR 
ROUTINES (IEECVML3, IEECVML5, IEECVML6, 
IEECVML7) CHART GD 



IEECVML3 is entered when the Write-to- 
Operator routine (IEEMFWTO) determines that 
a multiple- line WTO request has been 
entered in a system with multiple console 
support (MCS) . This routine builds a major 
WQE for a multiple- line WTO request. 

Upon entry, the routine checks to see if 
a major WQE already exists for the request. 
If so, the request is to build a minor WQE 
and control is passed to IEECVML5 to con- 
nect minor WQEs to the existing major WQE. 
If the request is to build a major WQE, the 
routine attempts to obtain WQE buffer space 
in main storage for the major WQE. If 
space is not available, and the request is 
from the communications task, DAR or an 
SIRB, an ENQ macro and a WAIT macro are 
issued for the WQE ECB. When buffer space 
has been obtained, the text fields are 
filled in. Control is then passed to 
IEECVML5 . 

IEECVML5 completes processing of the 
major WQE and begins processing of the 
minor WQE. If entry is to complete a major 
WQE, the MCS fields of the major are filled 
in. If no minors are to be chained to the 
major, control is passed to IEECVML6 to 
chain the major to the system output queue. 
If entry is made to connect minors to a 
major (or if, upon completion of a major, 
minors are ready to be connected to it) , 
buffer space for the minor WQEs is obtained 
in the same way that it was for the major 
WQE. (On subsequent entries to build minor 
WQEs, a check is made to see if any minor 
WQEs previously connected to the major have 
become available for reuse by having been 
written to all the consoles required by 
their routing indicators. If so, their 
buffer space is reused for another minor 
WQE.) As each minor WQE is completed, con- 
trol is passed to IEECVML6 to chain the re- 
quest to the system output queue. 

If IEECVML6 is entered to chain a major 
WQE to the system output queue, the parti- 
tion identifier (under MFT) and the MLWTO 
identification number are placed in the 
appropriate areas of the major WQE. If 
entry is to chain minor WQEs to the major, 
they are chained and appropriate hardcopy 
information and use count information is 
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moved into them from the major. If there 
are additional minor WQEs to be processed, 
control is returned to IEECVML5. Other- 
wise, control is passed to IEECVML7 which 
DEQs from the WTO resource if necessary, 
sets the appropriate return code in regist- 
er 15, and returns control to the routine 
that issued the request with an appropriate 
return code in register 15. 



WRITE TO OPERATOR WITH REPLY MODULE 



topost the external event control block 
(ECB) in the unit control module. 



ATTENTION INTERRUPTION HANDLER (IEECVCRA) 
CHART GB 



This module receives control as a result 
of an operator caused attention at an input 
or output device. IEECVCRA branches to 
post the attention event control block in 
the unit control module. 



(IEEVWTOR) CHART GE 



This module is entered from IEEMFWTO or 
IEENFWTO to process WTOR requests. If the 
parameter list is invalid or the message 
iength is not greater than 0, IEEVWTOR 
issues an ABEND macro instruction to 
abnormally terminate the task. If reply 
queue element is available, it is reinitia- 
lized and placed on the reply queue element 
chain which originates in the UCM. 

If a reply queue element (RPQE) is not 
available and the WTOR is issued by the 
communication task. System Log, DAR, or the 
system error task, IEEVWTOR issues a GET- 
MAIN macro instruction to obtain main 
storage for a reply queue element. Other- 
wise, if a reply queue element is not 
available, an ENQ macro instruction is 
issued to gain exclusive access to an RPQE. 
Upon return from ENQ, if a reply queue ele- 
ment is still not available, IEEVWTOR 
issues a WAIT macro instruction specifying 
the reply queue element buffer request ECB 
in the UCM. When a buffer becomes avail- 
able, processing resumes with initializing 
the reply queue element. IEEVWTOR issues 
an XCTL macro instruction to return control 
to IEECVWTO. 



WAIT MODULE (IEECVCTW) CHART GF 

This module issues a WAIT macro instruc- 
tion specifying a list of ECB addresses 
(EIL) . When one of the ECBs is posted, 
IEECVCTW issues an SVC 72 instruction which 
builds an SVRB for nonresident modules and 
gives control to the Router module, 
IEECVCTR. 



ROUTER MODULE (IEECVCTR) CHART GG 

This module determines from the ECBs 
pointed to by the event indication list 
(EIL) the type of interruption that has 
occurred. IEECVCTR issues an XCTL macro 
instruction to pass control to the appro- 
priate, nonresident, device- processor 
routine. 



CONSOLE SWITCH MODULE (IEECVCTX) CHART GH 

This module receives control from the 
Router module to switch from the primary to 
the alternate console as a result of an 
external interruption. 



EXTERNAL INTERRUPTION HANDLER (IEECVCRX) 
CHART GB 

This module receives control as a result 
of an external interruption and branches 



UNIT CONTROL MODULE (IEECVUCM) 

This nonexecutable resident module con- 
tains pointers, ECBs, and storage areas 
used by the communications task. 
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COMMUNICATIONS TASK ROUTINES FOR MULTIPLE CONSOLE SUPPORT 



The Initialization (IEECVCTI) , External 
Interruption Handler (IEECVCRX), Attention 
Handler (IEECVCRA) , and Unit Control 
(IEECVUCM) modules, which are common to 
both MCS and non-MCS communications tasks, 
are described under "Communications Task 
Routines • " 



MCS MINI-ROUTER MODULE (IEECMCTR) 

This routine is entered as a result of 
an SVC 72 instruction issued by the modules 
IEECMDSV, IEECMAWR, IEEC2740, and IEECMDOM. 
An SVRB is created as a result of the SVC 
instruction for the execution of this and 
the nonresident, device- processor modules. 
IEECMCTR issues an XCTL macro instruction 
to pass control to the appropriate device- 
processor module. See Diagram 16. 



MCS ROUTER MODULE (IEECMAWR) CHART GI 

The Router contains a WAIT macro 
instruction specifying the EIL and is 
entered when one of the five ECBs in the 
UCM or an I/O ECB is posted, or when pre- 
vious communication task processing 
requires additional output processing or 
queue management. As the highest priority 
ready task in the system, the Router 
examines the ECBs and queue management and 
output processing indicators in the follow- 
ing order: 

1. Recovery management 

2. External interruption 

3. Attention interruption 

4. I/O completion 

5. Output processing 

6. WTO, WTOR, WTP processing 

7. Queue management 

8. DOM processing 

9. NIP message- buffer processing 

The Router determines the processing 
necessary and passes control to the appro- 
priate communications task service module. 
When control returns, the Router re-tests 
all ECBs and status indicators that may 
have changed while the first interruption 
was being processed. To allow processing 
or higher- lev el interruptions, output pro- 



cessing returns control to the Router after 
each console output queue is processed (see 
IEECMDSV below) . When no further process- 
ing can be done, the Router reissues the 
WAIT macro instruction, and control returns 
to the Dispatcher. 



MCS CONSOLE SWITCH MODULES (IEECLCTX, 
IEECMCTX, IEECNCTX, AND IEECOCTX) CHART GJ 

The Console Switch modules receive con- 
trol from: 

• The Router to switch master consoles as 
a result of an external interruption. 

• The device support routines to switch 
to the alternate console when there is 
an unrecoverable I/O error on a 
console. 

• SVC 34 to switch to the alternate of 
the master console as a result of a 
VARY MSTCONS command. 

• IEECMDSV to switch the hard copy from 
the SYSLOG to the master console when 
SYSLOG is inoperative. 

IEECLCTX uses the parameter list passed 
by the calling routine to determine the 
type of function required. If entered 
because of a VARY MSTCONS command, IEECLCTX 
adds the routing and command codes of the 
master console to those of its alternate. 
IEECLCTX passes control to IEECOCTX if the 
master console was the hard copy log and 
its alternate is a graphics console. 
Otherwise, control is passed to IEECMCTX to 
issue indicative messages. 

If IEECLCTX was entered because of hard 
copy failure on SYSLOG, control is passed 
directly to IEECOCTX. 

If IEECLCTX was entered because of an 
external interruption or for a failing con- 
sole, the routing and command codes of the 
master or failing console are added to 
those of its alternate. If the new console 
is a graphics console and the old was the 
hard copy log, control is passed to 
IEECOCTX. Otherwise, for a successful con- 
sole switch, control is passed to IEECMCTX. 

If a secondary console does not have an 
active alternate, the routing and command 
codes are added to those of the master con- 
sole. If the master console does not have 
an active alternate, a message is issued to 
all active consoles requesting a VARY 
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Console Switch Parameter List 



16 



20 



Name of Console Switch Routine 



Flags | UCM entry address of failing 
j console, or New master UCM 
I entry address (VARY MSTCONS) 

x 



UCM entry of issuing console, or 
(for VARY MSTCONS) 



Flags : 



X'80' 


- Reserved 


X'40 B 


- Reserved 


X'20' 


- Reserved 


X'lO" 


- Reserved 


X'08' 


- VARY MSTCONS command 


X'04 f 


- External interruption 


X , 02' 


- Switch hard copy from 




SYSLOG to master 




console 


X'Ol' 


- Reserved 


X , 00 i 


- Console switch 



busy flag is set off in the UCM entry of 
the old console, and IEECNCTX returns con- 
trol to the calling routine. 

IEECOCTX switches the hard copy log to 
the alternate of a new console when the new 
console is a graphic device and the old 
console was receiving the hard copy. If 
the alternate console is also a graphics 
device, IEECOCTX searches all active con- 
soles starting with the master console for 
an active, nongraphics device. If none is 
found, the master console is specified as 
the hard copy device. When the hard copy 
log has been assigned to a console, a mes- 
sage indicating this is placed on the con- 
sole output queue of that console, the WQEs 
for the hard copy log are placed on the 
console output queue, and IEECOCTX passes 
control to IEECMCTX. 

IEECOCTX also switches the hard copy log 
from SYSLOG to the master console when 
there is a SYSLOG failure. If the master 
console is a graphics console, IEECOCTX 
searches for an active, nongraphics device 
as previously described, but does not 
requeue WQEs, and returns control to the 
calling routine instead of IEECMCTX. 



MSTCONS command from any console. If there 
are no active consoles and a console device 
is included that has an audible alarm, an 
OPEN macro instruction is issued for the 
device, and the alarm is sounded three 
times. For all cases where a console 
switch cannot be successfully made, 
IEECLCTX returns control to the calling 
routine. 

IEECMCTX constructs two messages to in- 
dicate to the operator that a console 
switch has occurred and the attributes of 
the new console. IEECMWSV is used to queue 
the WQEs to the console output queue of the 
new console. IEECMCTX passes control to 
IEECNCTX to adjust the output queues of the 
new console. 

IEECNCTX places the WQEs that were on 
the output queue of the old console on the 
console output queue of the new console, 
deleting duplicate messages. 

If the WQE represents an un ended 
multiple-line WTO, it is checked for 
Descriptor codes 8 and 9 
it is a status display) . 
codes 8 and 9 are found, 
deleted. Multiple-line WTO messages, other 
than status displays, are passed to the new 
console if the end line of the message is 
on the old console* s message queue at the 
time of the console switch. The close- 
pending indicator is set and the device 



(indicating that 
If Descriptor 
the WQE is 



MCS DEVICE INTERFACE MODULE (IEECMDSV) 
CHART GK 

This module consists of four subroutines 
that control the interface with the device- 
support processor routines and manage the 
output queues for the devices. It receives 
control from the Router when an attention 
or I/O ECB has been posted, when it has 
been processing output and there is more 
output to process (see DEVSERVA) , or when 
an output queue needs consolidating. It 
also receives control from the WTO process- 
ing routine IEECMWSV when there is output 
to be processed. 

DEVSERVB receives control when an atten- 
tion or I/O ECB has been posted. After 
testing console conditions, control is 
passed to DEVSERV to interface with the 
appropriate device- support routine. 

DEVSERVA receives control when there is 
more output to be processed. When it is 
first entered, it searches from the first 
UCM entry for a UCM entry of an active con- 
sole whose output queue can be processed. 
When it is subsequently entered from the 
Router, the search starts with the next 
entry after the last UCM entry processed. 
The search ends when an output queue is 
found that can be processed, or when the 
last UCM entry has been inspected. If an 
output queue is found, control is passed to 
DEVSERVA to interface with the appropriate 
device support routine. 
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Note : Because one WQE may be placed on 
several device output queues, and because 
DEVSERVA handles only one UCM entry each 
time it is entered, DEVSERVA may be re- 
entered from the Router to finish process- 
ing output queues. DEVSERVA must return to 
the Router after processing each output 
queue to allow for the servicing of higher 
priority external, attention, and I/O ECBs 
that may have been posted while DEVSERV was 
processing. 



DEVSERV is entered from DEVSERVA or 
DEVSERVB to branch to the appropriate 
device support routine. Upon return, if 
entries on the console output queue have 
been processed and marked as no longer 
needed, control is passed to the DEQ 
subroutine . 



The subroutine DEQ receives control when 
DEVSERV or CLEANUP need console output 
queues serviced. DEQ inspects the console 
output queue for WQE pointers that are no 
longer needed. Each WQE so flagged is 
marked as a null entry, and the use count 
of the WQE is decremented by one. If this 
decrementing results in the use count 
reaching (all specified consoles have 
received the message) , and DEQ determines 
that the message is to go to hard copy, 
control is passed to IEECMQCN (in IEECMWSV) 
to put the WQE pointer on the hard copy 
device's output queue, or a WTL is issued 
to SYSLOG. If the message is not to go to 
hard copy and there is no Reply Queue Ele- 
ment associated with the WQE, the WQE is 
freed or marked available. 

If a major WQE (representing a multiple- 
line WTO) has a related minor WQE with a 
use count of (indicating that it has been 
passed to all consoles), the WQE chain is 
searched. The storage space for all minor 
WQEs (except the last one) with a use count 
of zero is returned to the system. If a 
major WQE is flagged as no longer needed, 
the entire major/ minor WQE chain is 
released via FREEMAIN. Return is made when 
the last WQE pointer on the console output 
queue has been examined. 

CLEANUP receives control when system 
output queues need consolidation. It 
examines each WQE on the system output 
queue and passes control to DEQ for each 
WQE that has been serviced and is to be 
sent to hard copy. If the WQE isn't to be 
sent to hard copy, DEQ frees the WQE. Con- 
trol returns to CLEANUP to process all WQEs 
on the system output queue. 



WTO PROCESSOR MODULE (IEECMWSV) CHART GL 

This module gains control from the Rout- 
er when the WTO ECB is posted. WQEs that 
have been queued to the system output queue 
and have not been serviced by this routine 
are processed at this time. If a user exit 
routine is provided, a parameter list con- 
taining the text, routing codes, and 
descriptor codes is passed to it. If the 
routing codes have not been modified or 
suppressed, if the WQE is for a WTOR, or if 
there is no user exit routine, control is 
passed to the subroutine IEECMENQ, which 
compares routine codes, IDs, and hard copy 
requirements, and places the WQE on the 
appropriate console output queues . 

This routine sets an output-pending flag 
in the UCM to which the request has been 
queued. When all WQEs have been examined, 
control is passed to IEECMDSV (DEVSERVA) to 
initiate output queue processing. Upon 
return, control is returned to the Router. 



DOM SERVICE MODULE (IEECMDOM) CHART GM 

This module gains control from the Rout- 
er when the DOM ECB is posted (by the DOM 
macro instruction being issued in a problem 
program or system task) . It may also be 
entered directly from the system purge rou- 
tines at the end of a job step. When 
entered from the Router, message IDs in the 
DOM element list are compared with the WQEs 
on the system output queue. The matching 
WQEs are marked for deletion unless the WQE 
is to go only to hard copy. If a display 
console is active, control is passed to the 
processor routine for that device for 
deleting messages from the console screen. 
Upon return, the DOM element list is freed 
by a FREEMAIN macro instruction, and the 
DOM ECB is cleared. 

When entered from the system purge rou- 
tines, IEECMDOM compares WQEs with a pro- 
tect key. Those that match are marked for 
deletion unless they are to go only to hard 
copy. If any graphics consoles exist, the 
messages in each device's Display Control 
Module are similarly compared and marked 
for deletion. 



NIP MESSAGE BUFFER WRITER MODULE (IEECMWTL) 
CHART GN 

This module issues an SVC 35 to write 
the NIP messages to the hardcopy Log or 
hardcopy console. 



118 



COMMUNICATIONS TASK DEVICE SUPPORT ROUTINES 



The communications task with MFT sup- 
ports the following console devices in both 
MCS and non-MCS systems: 



• IBM 1052 Printer-Keyboard Models 5 
and 6 

• IBM 1403 , 1443, and 3211 Printers 

• IBM 2540 Card Read Punch 

The following console devices are also sup- 
ported in MFT f but only if the Multiple 
Console Support option is included in the 
system: 

• IBM 1052 Printer-Keyboard Model 7 

• IBM 2250 Display Unit 

• IBM 2260 Display Station 

• IBM 2740 Communication Terminal Model 1 

• IBM 5450 Operator Console with CRT 
Display 

The 2250 , 2260, and 5450 are discussed 
under "Device Independent Display Operator 
Console Support. n Following are descrip- 
tions of modules that support the 1052, 
1403/1443, 2540, and 2740. Where modules 
are used both with and without MCS, the 
differences are noted following the 
description of the non-MCS module. 



1052 DEVICE- SUPPORT ROUTINES 

The device-support routines for the IBM 
1052 Printer-Keyboard perform Read, Write, 
Open, and Close functions as well as buffer 
management (see Diagram 21). 



Processor Module 1 (IEECVPMX) Chart GO 

This module provides I/O buffer manage- 
ment and constructs channel programs to 
perform read and write operations. 



Processor Module 2 (IEECMPM1 in MCS) Chart 
GX (also IEECVPM1 in non-MCS) 

This module provides the processing 
necessary to present multiple- line WTOs 
(including system status displays) on the 
1052 Printer Keyboard operator console. 



Processor Module 1 with MCS (IEECMPMX) 
Chart GP 

Modification: This module does not perform 
buffer management. 



Open/Close Module (IEECVOCX) Chart GQ 

This module provides open and close 
functions for the console device. 



PRINTER DEVICE SUPPORT ROUTINES 

The device support routines for printers 
provide write, open and close functions, 
and buffer management. 



Processor Modules (IEECVPMP, IEEVPM1) 

These modules provide I/O buffer manage- 
ment and issues a WRITE macro instruction 
to cause output to the printer. 

Processor Module with MCS - (IEECMPMP) 

Modification: This module does not perform 
buffer management. 

Open/Close Module (IEECVOCP) 

This module provides open and close 
functions for the console device. 

Open/Close Module with MCS (IEECMOCP) 

This module provides open and close 
functions for the console device. 



CARD READER DEVICE SUPPORT ROUTINES 

The device support routines for card 
readers provide read, open, and close func- 
tions and buffer management. 

Processor Module (IEECVPMC) Chart GR 

This module provides I/O buffer manage- 
ment and issues a READ macro instruction to 
bring input from the card reader into a 
WQE. 

Processor Module with MCS (IEECMPMC) 
Chart GS 

Modification: This module does not perform 
buffer management. 
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Open/Close Module (IEECVOCC) 

This module provides open and close 
functions for the console device. 



instruction is issued on the BTAM modules 
and the active flags in the UCM entry and 
the control blocks are set to indicate that 
the device is closed. 



2740 DEVICE SUPPORT ROUTINES (MCS ONLY) 
CHART GT 

The 2740 Communications Terminal Model 1 
is available only in systems that include 
MCS. The 2740 Processor routine , IEEC2740, 
is created at System Generation by the 
macro instruction SGIHB000. It performs 
OPEN and CLOSE; READ and WRITE use the fol- 
lowing BTAM modules: 

• IGG019MA, BTAM read/write routine 

• IGG019MB, BTAM channel end and abnormal 
end appendages 

• IGG019M0, BTAM device I/O module (table 
used by IGG019MA) 

Diagram 21 illustrates the logic flow of 
the 2740 routines. 

OPEN is performed when the open pending 
flag in the UCM entry is on and the UCM 
entry is not already open. A LOAD is 
issued to obtain the addresses of the BTAM 
modules. The address of the 2740 ECB is 
placed in the UCM entry and Event Indica- 
tion List. The DEB is initialized from the 
Communications Task TCB and placed at the 
head of the TCB DEB queue. The Appendage 
Vector Table is initialized and the line to 
the 2740 is initialized via the LOPEN macro 
instruction. The open flag of the DCB is 
turned on, the active flag of the UCM entry 
is turned on, and the open pending flag is 
turned off. 

CLOSE is performed when the close pend- 
ing flag in the UCM entry is on, the output 
queue is empty, and the console is not 
busy. The address of the ECB in the EIL is 
replaced with the address of the UCM entry, 
the address of the ECB in the UCM entry is 
set to 0, the DEB is removed from the TCB 
DEB queue, and the UCB is set to indicate 
that it can be allocated. A DELETE macro 



READ is performed when the 2740 is not 
busy and a message has been sent to the 
terminal or when a READ I/O complete has 
been successfully processed and the output 
queue is empty. The BTAM module IGG019MA 
is given control to perform the function 
and, if the read is successful, the busy 
flag is set in the UCM entry. 

WRITE is performed when the output pend- 
ing flag in the UCM entry is set, the 2740 
is not busy, and the output queue is not 
empty. WQE pointers on the console output 
queue are examined. When a WQE is found 
that can be written, control is passed to 
IGG019MA. If the writing operation was 
successful, the busy flag is set in the UCM 
entry. 

For I/O complete conditions, IEE2740 
turns off the busy flag in the UCM entry. 
If the complete is for a successful READ, 
the message text is translated from 2740 
code to EBCDIC and searched for backspace 
and cancel codes. If the message is to be 
ignored, control is passed to IGG019MA for 
another READ operation. If the message is 
to be accepted, an SVC 34 instruction 
causes the message to be passed to the 
Master Scheduler for the reply processing. 
Upon return from the Master Scheduler, the 
processor will attempt to write if the 2740 
is not busy and there is output on the con- 
sole output queue. If the 2740 is busy, 
control is returned to the Communications 
Task module IEECMDSV. If the I/O complete 
condition is for a WRITE, the WQE pointer 
in the console output queue is marked as no 
longer needed, and control is returned to 
IEECMDSV. 

If a condition code other than or 4 is 
returned by a BTAM module, the 2740 proces- 
sor will retry the I/O operation, or con- 
trol will be passed to the Console Switch 
routine IEECMCSW in the Communications 
Task. 
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TIMER SUPERVISION ROUTINES 



The timer supervision routines provide 
the processing necessary for the TIME, 
TTIME, and STIMER macro instructions, which 
use the System/360 interval timer feature 
and the System/370 Time-of-Day Clock. The 
timer second-level interruption handler 
processes interruptions that occur when the 
interval timer expires. 



TIMER SECOND LEVEL INTERRUPTION HANDLER 
(IEA0TI00)* CHART HB 

♦The module used depends upon the timer 
options specified at system generation and 
the availability of the Time-of-Day Clock 
(System/370 models only) . Figure 39 lists 
the timer SLIH module names. 

Upon entry, the timer second- level 
interruption handler (SLIH) tests the timer 
to ensure that it is negative. If it is 
positive, control is returned to the timer/ 
external first-^level interruption handler 
(FLIH) . The timer SLIH obtains the topmost 
timer queue element (TQE) from the timer 
queue and tests the first word of the TQE. 
Figure 40 lists the processing done by the 
timer SLIH in response to the flag-field 
values. 

Timer SLIH with System/370 Time-of-Day 
Clock, Chart HH 

In System/370, the timer SLIH determines 
if the top element in the TQE chain is a 
synchronized element (greater than one hour 
interval) . For a synchronized TQE, the 
remaining interval is checked and if still 
greater than one hour, the new interval is 
set to one hour and the TQE remains on the 
TQE queue. If the remaining interval is 
less than or equal to one hour (and is 
positive) , the TQE synchronize indicator is 
turned off, the remaining interval is 
placed in the TQEVAL field, and the TQE is 
returned to the queue in time-of- expiration 
order. If the remaining interval is or 
negative, the interval has expired and 
normal System/360 processing continues. 
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TIME (IEA0RT00) CHART HA 

TIME calculates the time of day in timer 
units and converts the time to binary or 
decimal units if requested. If the timer 
has expired and a twenty-four hour TQE was 
the topmost element, TIME calculates a new 
date. The time is returned to the caller 
in register and the date in register 1. 

TIME in System/370 with Time-of-Day Clock 
Processing, Chart HE 

In System/370, the TIME routine verifies 
the date in the communications vector table 
each time the routine is entered. The 
value in the TOD Clock is compared to the 
expected midnight value. When the current 
value exceeds the expected value, the CVD- 
ATE field is updated and a new expected 
midnight value is stored in the TQE. 

TIME then obtains the time of day value 
from the TOD Clock. For a request specify- 
ing the time in microseconds, the date is 
returned in register 1, and the time of day 
is placed in the storage area specified by 
the requester. If the request was for time 
of day to be returned in either binary, 
decimal, or in timer units, the microsecond 
value is converted to the proper value and 
the time of day is returned in register 0, 
the date in register 1. 



TTIMER (IEA0ST00) CHART HC 

If the TQE of the caller's TCB is not 
queued to the timer queue, then it has 
already expired, and a remaining time of 
is returned to the caller. If the TQE has 
not expired, TTIMER calculates the remain- 
ing time. If the cancel option was speci- 
fied, TTIMER branches to the timer SLIH to 
dequeue the TQE from the timer queue. The 
remaining time is then passed to the caller 
in register 0, and control is returned 
through the type-1 EXIT routine. 

TTIMER in System/370 with Time-of-Day Clock 
Processing, Chart HF 

In System/370, the Time-of-Day Clock is 
used by the TTIMER routine to calculate the 
time remaining in the interval if the syn- 
chronous TQE indicator is set. 



STIMER (I3SA0ST00) CHART HP 

Control is immediately returned to the 
caller if its TCB does not address a timer 
queue element (TQE) . The STIMER routine 
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h 



Bits 
4-7 

Of TQE 



Indicates That: 



Elapsed Time 
Represents: 



Action Taken by 
Timer Second-Level 
Interruption Handler 



0000 



I— 



TASK parameter was 
used in STIMER macro 
instruction. 



Time used to perform 
task for which the 
STIMER macro instruc- 
tion was given. 



Checks bit 3, which contains a 
1 if an asynchronous exit 
routine is to be entered. If 
so, passes control to Stage 2 
Exit Effector. 



H 



3-010X 



h 



10100 



0110 



Interval that ex- 
pired was a 6 -hour 
supervisor interval- 



Total elapsed time, 
measured from time 
that interval was 
placed into timer. 



Checks bit 7, which will contain 
a 1 if a 24-hour period has 
passed. If so, increments date 
by 1. 



Interval that ex- 
pired was a 10- 
minute supervisor 
interval. 



Total elapsed time 
measured from time 
that interval was 
placed into timer. 



H 



WAIT parameter was 
used in STIMER macro 
instruction. 



Total elapsed time, 
measured from time 
that interval was 
placed into timer. 



Computes system wait time and 
stores in system management 
control area. Sets accumulated 
wait time field to 0. 



Issues POST macro instruction. 
(Performance of task for which 
macro instruction was issued 
cannot be resumed until POST is 
given. ) 



1000 



l~ 



REAL parameter was 
used in STIMER 
macro instruction. 



Total elapsed time, 
measured from time 
that interval was 
placed into timer. 



Checks bit 3, which will 
contain a 1 if an asynchronous 
exit routine is to be entered. 
If so, gives control to Stage 2 
Exit Effector. 2 



A The address of the 10-minute supervisor element is compared with the address of the 
top TQE to determine if the interval that expired was a 10-minute or 6-hour supervi- 
sor element. 

2 If an Initiator issued the STIMER macro instruction, the TQE will be converted to 
TASK type, and control will be passed to ABTERM. 

L 

Figure 40. Timer SLIH Processing 



converts the specified interval to timer 
units if the decimal or binary options were 
specified. If the time of day was speci- 
fied, STIMER calculates an interval that 
will cause the timer to expire at the spec- 
ified time of day. 

If the TQE addressed by the caller's TCB 
is active, STIMER uses the timer SLIH to 
cancel the interval. The TQE is reinitial- 
ized to represent the new interval. If an 
exit address was specified by the caller, a 
save area is acquired for the exit routine 
if one was not provided by the caller. The 
TQE is then placed on the timer queue and 
timing begins. 

If the TQE addressed by the caller* s TCB 
is not active (not currently on the timer 
queue) , a test is made to determine whether 
the TQE has been flagged as an active IRB. 
(This is done because an active IRB would 
indicate that the caller is a timer user- 
exit routine.) The STIMER macro instruc- 
tion is effectively a NOP if issued by a 
timer user-exit routine, and control is 



returned to the caller. If the TQE has not 
been flagged as an active IRB, it is 
initialized to represent the requested 
interval. If an exit address was specified 
by the caller, a save area is acquired for 
the timer user-exit routine if one was not 
provided by the caller. The TQE is then 
placed on the timer queue and timing begins. 

When timing has begun, STIMER determines 
whether the caller has requested to wait on 
the time of expiration. If the caller 
specified the wait option, STIMER obtains 
the ECB address and issues a WAIT macro 
instruction to place the caller in the wait 
condition pending expiration of the 
interval . 

STIMER in System/370 with Time-of-Day Clock 
Processing , Chart HG 

STIMER in System/370 uses the TOD Clock 
to calculate the interval and the expected 
time of expiration of the interval. For 
REAL or WAIT type requested intervals in 
excess of one hour, STIMER flags the TQE as 
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synchronized, stores the expected value of 
the TOD Clock at expiration in the TQEWORK 
field of the TQE, and sets the interval to 
one hour. The TQE is thus checked every 
hour until the entire requested interval 
has expired. When the interval becomes 
less than one hour, the timer second-level 
interruption handler turns off the synch- 
ronizing bit and places the TQE back on the 
queue as a non-synchronized TQE. 



The user routine determines whether or 
not a time extension is allowed. It 
returns control to the SMF Time Limit 
Expiration routine with a return code of 
if the time limit is extended, 4 if it is 
not extended. If the return code is 4, 
Register 1 contains the number of timer 
units allowed for the extension. The SMF 
Time Limit Expiration routine places the 
value of the extension into the expired TQE 
and places the TQE back on the timer queue. 



SMF TIME LIMIT EXPIRATION ROUTINE 
(IEATLEXT) CHART MB 

This routine, which resides in the nuc- 
leus, provides an interface with a user 
time limit expiration routine (IEFUTL). It 
receives control after a job step or wait 
time limit has expired (see above). It 
passes control to the user time limit rou- 
tine, indicating the type of expiration in 
Register 15. It also passes the address of 
a 7 2 -byte register save area and the con- 
tents of the user data field (TCTUDATA) in 
the TCT. 



If no extension is granted, the action 
taken depends on the type of time limit 
that has expired: 

• If wait time expired, the problem pro- 
gram will be abnormally terminated with 
an error code of 522. 

• If job-step time expired, the step will 
be terminated with a completion code of 
322. The SMF Wait Time Expiration rou- 
tine converts the TQE into an IRB/IQE 
for standard linkage to the Stage 2 
Exit Effector. 
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OVERLAY SUPERVISION ROUTINE DESCRIPTIONS 



RESIDENT OVERLAY SUPERVISOR (IEWSVOVR) 
CHART IA 

The overlay supervisor first determines 
the cause of the interruption. N If it was a 
SEGLD macro instruction, the overlay super- 
visor returns control to the caller since 
SEGLD is a NOP instruction in MFT. If the 
interruption was caused by a SEGWT macro 
instruction, the supervisor determines if a 
direct branch entry to the requested seg- 
ment, via the caller" s entry table (ENTAB) , 
has been prepared because of a previous 
branch or CALL macro instruction. If the 
branch or CALL was prepared, the supervisor 
returns control to the requester, because 
processing of the request is not needed. 

If a branch entry was not prepared, the 
overlay supervisor performs initialization 
and issues a LINK macro to request contents 
supervision assisted linkage to the nonres- 
ident module IEWSZOVR. (IEWSZOVR is the 
name on the linkage library given to either 
IEWSYOVR or IEWSXOVR. Either of these two 
modules may be selected during system 
generation . ) 



NONRESIDENT OVERLAY SUPERVISOR (IEWSZOVR) 
CHART IA 

IEWSZOVR is the library name for either 
IEWSYOVR (Basic Synchronous Transient Over- 
lay Supervisor module) or IEWSXOVR (Synch- 
ronous Transient Overlay Supervisor module 
with optional SEGWT checking) . 

IEWSZOVR processes the request depending 
on the following conditions: 

• If the requester issued a SEGWT (SVC 
37) and the requested segment and/or 



segments in its path are not in main 
storage, then IEWSZOVR branches to 
FINCH to bring the needed module into 
storage. The caller's entry table is 
not altered to prepare for a branch to 
the requested segment. Control is 
returned to the caller only after the 
requested segment and any segments in 
its path have been loaded. IEWSZOVR 
then branches back to the requester. 
(The requested segment is not entered.) 

• If the requested segment or segments in 
its path are in main storage, IEWSZOVR 
returns to the caller. 

• If the requester issues a branch or 
CALL and the segment was previously 
requested by a SEGWT, the overlay 
supervisor alters the caller's entry 
table to prepare for a future branch to 
the same external address without 
reentering the overlay supervisor. 

• If the requester issues a branch or 
CALL and the segment was not previously 
requested by a SEGWT, the overlay 
supervisor branches to FINCH to bring 
the needed segments into main storage. 
The caller's entry table is altered to 
prepare for a future branch to the same 
external address without entering the 
overlay supervisor. Control is then 
given to the requested segment at the 
specified address. 

• If the caller previously issued a CALL 
or branch instruction specifying the 
same external address, the overlay 
supervisor is not entered. The call- 
er's entry table, altered by the pre- 
vious call or branch, provides a direct 
branch to the requested segment. 
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CHECKPOINT/RESTART ROUTINES 



The Checkpoint/Restart routines provide 
the processing necessary to save the prob- 
lem program and its environment at a speci- 
fied point (Checkpoint), and to restore 
this program and environment when an 
abnormal termination occurs and return con- 
trol to the restored program (Restart) . 



CHKPT (SVC 63) CHART LA 
CHKPT: 

1. Suspends user I/O requests. 

2. Builds a checkpoint entry and writes 
it in the checkpoint data set. 

3. Restores the user I/O requests. 

4. Returns to the caller. 

If the caller has suppressed checkpoints , 
through use of the RD parameter in job con- 
trol statements , no CHKPT entry is written. 

The routine consists of 10 load modules 
which are executed in the SVC transient 
area after an SVC 63 instruction (CHKPT) 
macro instruction is issued. When the SVC 
63 instruction is executed # an SVC inter- 
ruption occurs and control passes to the 
SVC FLIH, the SVC SLIH, and to the first 
load module of CHKPT (see Figure 41). The 
remaining load modules receive control via 
XCTL macro instructions. 

Initialization Modules (IGC0006C, IGC0106C, 
IGC0206C) 

The first load module of CHKPT 
(IGC0006C) determines if checkpoints have 
been suppressed. If they have or if a sub- 
task is active in the partition, an SVC 3 
instruction is issued to pass control to 
the SVC EXIT routine and return to the 
caller. If they have not, module IHJACP00 
determines if the CANCEL operand was speci- 
fied in the CHKPT macro instruction being 
serviced. If CANCEL was specified, pro- 
cessing continues as described below in 
"CANCEL Processing." If CANCEL was not 
specified, module IGC0006C issues an OPEN 
macro instruction for the checkpoint data 
set (if the caller has not already opened 
the data set) and then issues a GETMAIN 
macro instruction for a work area in the 
dynamic area of main storage. The second 
load module (IGC0106C) tests the validity 
of the request. If an error is detected, 
control passes to checkpoint exit module 
(IG0Q06C) . If no errors are found, the 



CHKPT Macro Instruction 
SVC 63 Interruption 



SVC FLIH 



SVC SLIH 



Checkpoint Service 
Routines 



EXIT Routine 
(SVC 3) 



Figure 41. Checkpoint Routine Control Flow 



third load module (IGC0206C) reads the job 
control table (JCT) into the work area, 
builds the checkpoint header recorder 
(CHR) , and passes control to the check I/O 
module . 

CANCEL Processing 

The CANCEL operand of the CHKPT macro 
instruction indicates that the caller does 
not want to create a new checkpoint entry, 
but wants to suppress automatic restarts 
from any previously created checkpoints. 
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When CANCEL is specified, module IGC0006C 
issues a GETMAIN macro instruction to 
obtain a small work area and then passes 
control to module IGC0206C. Module 
IGC0206C reads the job control table (JCT) 
into the work area and passes control to 
the exit module, (IGC0Q06C). 



The exit module sets a checkpoint indi- 
cator to show that no checkpoint entry has 
been written, and alters the JCT so that it 
doesn't show the previous checkpoint 
entries which have been written. The exit 
module then returns the JCT to the input 
queue and returns control to the caller via 
an SVC 3 instruction. (No messages are 
written to the operator.) 



If an abnormal termination occurs after 
CANCEL processing has been completed, 
checkpoint/restart is not performed. 
However, the checkpoint entries that have 
been written are retained, and the pro- 
grammer can restart the step from one of 
these entries at a later time by submitting 
the proper restart job control language. 



Checkmain Module (IGC0F06C) 

The checkmain module writes the contents 
of problem-program main storage onto core 
image records (CIRs) . Then a supervisor 
record (SUR) is constructed with task con- 
trol information and written as the last 
record in the checkpoint entry. Control 
then passes to the resume I/O module via an 
XCTL. If an I/O error occurs or end-of - 
volume is detected on either tape for the 
second time or on a direct access device, 
control is passed to the resume I/O module 
with an error code. If the end-of -volume 
occurs for the first time on tape, control 
is passed to IGC0206C to reprocess the 
tape. 



Resume I/O Module (IGC0N06C) 

The resume I/O module issues the RESTORE 
macro instruction for each data extent 
block (DEB) associated with a previously 
suspended I/O request. The requests are 
restored to the logical channel queues, and 
if possible, started. Control is then 
passed to exit module, (IGC0Q06C) . 



Check I/O Module (IGC0506C) 

The check I/O module issues a PURGE 
macro instruction specifying the QUIESCE 
option for each data extent block (DEB) 
associated with the caller* s task control 
block. This causes all of the caller's 
pending I/O requests to be removed from the 
logical channel queues or, if they are 
being serviced, to be completed. If a per- 
manent error occurs in a QSAM or QISAM I/O 
request, an error code is returned to the 
caller, and no checkpoint is written 
(unless the QSAM ACC option was specified 
for the data set) . When all of the call- 
er' s I/O activity has completed, control 
passes to the preserve 1 module (IGC0A06C). 



Preserve Modules (IGC0A06C, IGC0D06C) 

The preserve modules write the check- 
point header record (CHR) created by the 
third module, then build and write a data 
set descriptor record (DSDR) for each job 
file control block, job file control block 
extension, and generation data group bias 
count table. If end-of- volume occurs for 
the checkpoint data set on tape, IGC0206C 
is called to attempt to rewrite with a new 
tape. If end-of -volume occurs for the 
second time on tape or the checkpoint data 
set is on a direct access device and end- 
of -volume is detected or an I/O error 
occurs in either module, control is trans- 
ferred via XCTL to the resume I/O module. 
If none of the above errors occurs control 
then passes to the checkmain module. 



Exit Module (IGC0Q06C) 

For a normal exit, IHJACP50 issues a 
STOW macro instruction if the checkpoint 
data set has a partitioned organization. 
It then issues a CLOSE macro instruction 
for the checkpoint data set (unless the 
caller issued the OPEN) , updates the check- 
point flags and count fields in the job 
control table (JCT) , restores the JCT to 
the job queue, and frees the work area. 
For an exit after an error has occurred, 
the preceding functions are performed if 
necessary. Control is then passed to the 
message module. 



Message Module (IGC0S06C) 

The message module writes a message 
indicating successful or unsuccessful com- 
pletion. One of the following return codes 
is placed in Register 15 before control is 
returned to the caller via an SVC 3 
instruction: 

X'OO" Valid checkpoint entry written. 

X'08 f No checkpoint written; calling 
error. 

X'OC Permanent I/O error. 

X'lO" A valid checkpoint entry was 

written, but there were outstand- 
ing ENQs. It is the responsibil- 
ity of the user to restore these 
ENQs during restart. 
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RESTART (SVC 52) CHART LB 

RESTART uses information in a checkpoint 
entry to recreate the conditions that 
existed when the checkpoint entry was writ- 
ten. RESTART: 



Restores the problem program to its 
original location in main storage. 



2. Opens and positions any problem pro- 
gram data sets that were open when the 
checkpoint entry was written. 

3. Restores task control information. 

4. Passes control to the problem program 
instruction immediately following the 
CHKPT macro instruction from which 
RESTART is occurring. 

The routine consists of 14 load modules 
which are executed in the SVC transient 
area after an SVC 52 instruction is issued. 
Before the SVC 52 instruction is issued, a 
job management routine (IEFDSDRP) adjusts 
the job queue and ensures that device allo- 
cations are compatible with those which 
were in effect when the CHKPT macro 
instruction was issued. Just before exit- 
ing , IEFDSDRP changes the name of the 
restarting step to IEFRSTRT. This program 
consists of only an SVC 52 instruction. 

When the SVC 52 instruction is executed, 
an SVC interruption occurs and control is 
passed to the SVC FLIH, the SVC SLIH, and 
to first load module of the RESTART (see 
Figure 42) . 



Initialization Modules (IGC0105B, IGC0205B) 

The first load module of RESTART 
(IGC0105B) receives the address of a para- 
meter list built by job management routines 
from information in the checkpoint header 
record (CHR) . From this parameter list, 
RESTART determines what the problem pro- 
grants boundaries were when the checkpoint 
entry was written. It then issues a GET- 
MAIN macro instruction for the same area 
(this includes a RESTART work area) . A 
data control block (DCB) for the checkpoint 
data set is constructed in the work area, 
and the RESTART SVRB and the current task 
input/output table (TI0T) are moved into 
the area. An OPEN macro instruction is 
issued for the checkpoint data set, and the 
next module is called. 

The second load module (IGC0205B) moves 
additional checkpoint data set control 
blocks into the work area. It positions 
the checkpoint data set at the first core 
image record (CIR) and calls the REPMAIN. 



SVC 52 Interruption 
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SVC FLIH 



SVC SLIH 



Restart Service 
Routines 




EXIT 

Routine 
(SVC 3) 



ABEND 
Routine 
(SVC 13) 



Figure 42. Restart Routine Control Flow 



REPMAIN Modules (IGC0505B, IGC0605B) 

The REPMAIN module IGC0505B reads the 
core image records (CIR) into problem pro- 
gram storage and the supervisor record 
(SUR) into the work area from the check- 
point data set. If the size of the parti- 
tion has been increased, the free area 
queue element is adjusted accordingly, and 
the address of the FQE is moved into the 
boundary box. If the system includes the 
protection feature, each 2K block of main 
storage within the partition is set to the 
specified protection key. 

The REPMAIN module IGC0605B restores the 
TCB fields and any floating point registers 
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that were saved by the CHECKMAIN module in 
the supervisor record (SUR). If subtasking 
is included in the system, the pointer to 
the job pack area queue is restored in the 
program information block CPIB) . The pro- 
tection key in the TCB is stored in all re- 
quest blocks (except supervisor request 
blocks) that are queued to the TCB. The 
protection key and the TCB address are also 
stored in all data extent blocks (DEB) 
queued to the TCB. Control is then passed 
to the first job file control block pro- 
cessing module (IGC0G05B) . 

Job File Control Block Processing Modules 
(IGC0G05B, IGC0G95B, IGC0I05B) 

The first two job file control block 
(JFCB) processing modules (IGC0G05B and 
IGC095B) create a table in the work area 
for each JFCB associated with a data set 
that was open when the CHKPT macro instruc- 
tion was issued. A DEB, a DCB r an IOB, and 
an ECB are constructed within the table for 
later repositioning I/O operations. Con- 
trol then passes to the second JFCB pro- 
cessing module. 

The third JFCB processing module (IGC- 
0I05B) reads in a JFCB extension for 
sequential access method (SAM) data sets 
that reside on more than five volumes. 
Several extensions may be read until the 
one containing the volume serial number 
that was in use when the CHKPT macro 
instruction was issued is found. Unless 
all problem program data sets reside on 
direct access storage devices, control 
passes to the first mount/verify module. 
If all data sets are on direct access 
storage, control passes to the direct 
access mount/ verify module. 

The Dummy Data Set Processor (IGC0H05B) 
receives control from IGC0I05B if any of 
the data set description tables correspond 
to a dummy data set. (For a discussion of 
dummy data sets, refer to Job Control 
Reference .) 

For each dummy data set encountered, a 
check is made to determine if the data set 
was a dummy data set when the checkpoint 
was made. If it was, no further processing 
is done. 

For each dummy data set that was not a 
dummy data set when the checkpoint was 
taken, IGC0H05B deletes the subroutine 
loaded by the OPEN macro instruction, and 
unchains and frees the DEB associated with 
the data set. If the data set was being 
processed by QSAM or BSAM and the check- 
point was not made during an end-of -volume 
exit for the data set, IGC0H05B frees the 
IOBs created by the OPEN macro instruction, 
creates a dummy DEB and adds it to the DEB 
chain, loads the dummy access method (IGCO- 



19AV) , and sets pointers to it in the DCB 
associated with the data set. 

An error condition exists if a data set 
that has been made a dummy is not being 
processed by either QSAM or BSAM at the 
time the checkpoint was made, or if the 
checkpoint was made during an end-of-volume 
exit. When an error occurs, an error code 
of 79 is placed in the restart work area. 

If no errors are detected, control is 
passed to the mount verification portion of 
Restart once all of the table entries have 
been processed. 

If an error has been detected, control 
is passed to the Restart Error routine 
(IGC0V05B) . 

TCAM Data Set Processor (IGC0J05B) 

If there are any TCAM data sets to be 
restarted, the TCAM data set processor 
receives control from IGC0G95B. It ini- 
tializes the TCAM region and sets up TCAM 
control blocks and queues for each data 
set. Control is given to the Restart Error 
routine (IGC0V05B) if the data sefs QNAME 
parameter is not known to TCAM, if the pro- 
cess entry defined by QNAME is already 
being used, or if a GETMAIN by TCAM was 
unsuccessful. If IGC0J05B executes normal- 
ly, control is passed to the last JFCB Pro- 
cessor (IGC0I05B). 

Mount/Verify Modules (IGC0K05B, IGC0M05B) 

The first mount/verify module (IGC0K05B) 
processes all data sets except those resid- 
ing on direct access devices. For SYSIN, 
SYSOUT, unit record, and graphics data 
sets, processing consists only of adjusting 
the data extent block (DEB). 

For magnetic tape data sets, the volume 
serial number in the primary unit control 
block (UCB) in the data set's task input/ 
output table (TIOT) entry is compared to 
the volume serial number in the work-area 
table built from the data set descriptor 
record (DSDR) . If they are the same, the 
necessary adjustments are made to the UCB 
and the DEB. If the volume serial numbers 
do not match, the secondary UCBs (if any) 
are searched. If the correct volume is 
specified in one of them, it becomes the 
primary UCB, If the volume is not mounted, 
a suitable UCB is selected from the TIOT 
entry, and a MOUNT message is written to 
the operator. For any tapes with nonstan- 
dard labels, a user-supplied verification 
subroutine is called. After all tape data 
sets are processed, control is passed to 
the direct access mount/verify module. 

The direct access mount/ verify module 
(IGC0M05B) performs exactly the same func- 
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tions as the first mount/verify module, 
except that no label checking is done, and 
all volumes of a concatenated data set with 
partitioned or direct access organization 
are mounted. An error, such as no suitable 
UCB for a volume, causes RESTART to termi- 
nate with an error message. If no error 
occurs, control is passed to the first 
direct access position I/O module 
(IGC0N05B). 



SYSIN/SYSOUT Nondirect Access Data Set 
Processor (IGCQL05B) 

This module receives control from 
IGC0K05B or IGC0M05B for certain SYSIN or 
SYSOUT data sets. It primes the buffers 
for a SYSIN data set from the card reader 
or writes header labels on a SYSOUT tape 
data set with deferred restart. If an 
ASCII label is used on a SYSOUT tape or an 
error occurs in writing the SYSOUT header 
labels, control is given to the Restart 
Exit routine (IGC0V05B). Otherwise control 
goes to IGC0N05B (for SYSIN/SYSOUT data 
sets on direct access) or to IGC0P05B. 

Position I/O Modules (IGC0N05B, IGC0Q05B, 
IGC0P05B, IGC0R05B, IGC0S05B) 

The first direct access position I/O 
module (IGC0N05B) adjusts the DCB, DEB, and 
channel programs for direct access data 
sets that have been deleted. When process- 
ing is completed, control is passed to the 
second direct access position I/O module 
(IGC0Q05B) . This module calculates the 
number of tracks in each extent in each 
SYSIN or SYSOUT DEB and places the number 
in the DEB. It passes control to nondirect 
access position I/O module IGC0P05B or to 
direct access position I/O module IGC0R05B. 

The nondirect access position I/O module 
moves magnetic tape data sets to where they 
were located when the CHKPT macro instruc- 
tion was issued. IGC0P05B assumes the 
following : 

• System input data sets have been posi- 
tioned by the scheduler to the first 
data record of the user's input stream. 

© Nonstandard label data sets have been 
positioned by the user label routine to 
the first data reocrd on the current 
volume. 

• If this is a deferred restart, system 
output data sets have been positioned 
by module IGC0L05B. (If this is an 
automatic restart, system output data 
sets will be rewound and positioned 
now.) 

• All other tape data sets are positioned 
at load point. 



IGC0P05B positions tapes with standard 
labels or no labels to the first data rec- 
ord. Then, using the BLKCT field of the 
DCB, IGC0P05B advances each tape data set 
to where it was located when the CHKPT 
macro instruction was issued. If the BLKCT 
field is negative or 0, the data set is 
positioned to the beginning or end, depend- 
ing on whether forward or backward process- 
ing was in progress when the CHKPT macro 
instruction was issued. Control then 
passes to the final processing module or to 
IGC0S05B. 

The Data Set Processor 1A (IGC0S05B) 
module works from the data set description 
table, processing all magnetic tape data 
sets except those tapes created under DOS 
which contain either embedded checkpoint 
records or possibly a leading tapemark. On 
entry, all but two types of tape volumes 
are positioned at the load point. The 
exceptions are SYSIN data sets, which are 
positioned to read the first user input 
record, and nonstandard labeled tapes, 
which are positioned at the first data rec- 
ord by the user label routine. 

Data Set Processor 1A first advances the 
tape past the label, if necessary, to the 
correct data set, using the file sequence 
number. Then the DCB block count field 
(DCBBLKCT), saved at CHKPT, is used to 
advance the data set to the correct record. 
If the DCBBLKCT field is zero or negative, 
the data set is positioned at the first 
record of end-of-file, depending on whether 
the forward or backward processing was tak- 
ing place at CHKPT time. An I/O error in 
repositioning causes Restart termination. 

IGC0S05B passes control to IGC0U05B if 
any data sets are open at CHKPT time for 
which either a leading tapemark or embedded 
DOS checkpoint record is indicated. Posi- 
tioning of these tapes occurs similarly as 
in IGC0S05B with two exceptions: 

1. For the indication of a leading tape- 
mark, a READ is issued and the result- 
ing status is tested for indication of 
a unit exception. If a tapemark is 
not sensed, the tape is repositioned 
to the load point prior to performing 
record positioning. 

2. To perform record positioning of data 
sets containing DOS embedded check- 
point records requires the reading of 
the first 20 bytes of every block. 
During record positioning, the 
embedded checkpoint records encoun- 
tered are spaced over and are not 
reflected in the block count. 

The Data Set Processor 2 module is 
called from IGC0S05B except when the above 
described DOS tape volumes require posi- 
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tioning. If either of these tape volumes 
requires positioning, the Data Set Proces- 
sor 2 module is called from IGC0U05B. If 
there are no direct access data sets, the 
Access Method Disposition module (IGC0T05B) 
is given control. 

The Data Set Processor 2 module 
(IGC0R05B) checks each data set residing on 
a direct access storage device to determine 
if the space allocation limits of the data 
set (described in the data set control 
block (DSCB) on the volume) have changed 
since the CHKPT macro instruction was 
issued. The limits which existed at that 
time are described in the data extent block 
(DEB) saved by CHKPT. If the space alloca- 
tion limits of an input data set have 
changed (indicating that the data set has 
been modified) , RESTART is terminated. 

If the space allocation limits of an 
output data set have changed, the smaller 
of the two space allocations is placed in 
both the DSCB and the DEB. If the DSCB 
allocation is reduced, the partial release 
module of the CLOSE routine is called to 
return the released space to the free area. 
When all direct access data sets have been 
checked, control passes to the final pro- 
cessing module. 

ISAM and BDAM Data Set Procesor (IGC0W05B) 

If there are any ISAM or BDAM data sets 
to be restarted, IGC0W05B receives control 
from IGC0R05B. For ISAM data sets, it 
reads the Format 2 DSCB and then gives con- 
trol to ISAM OPEN (IGC01920 or IGC01950) to 
validate certain pointers in the DSCB. If 
an I/O error occurs in the ISAM OPEN 
module, IGC0W05B sets a return code and 
gives control to the Restart Exit routine 
(IGC0V05V). For BDAM data sets, IGC0W05B 
reinitializes addresses within reentrant 
BDAM access method modules. IGC0W05B then 
passes control to the I/O Restart routine 
(IGC0T05B). 



Final Processing Module (IGC0T05B) 

The final processing module reads the 
directories of any user output data sets 
with partitioned organization to detect 
members added after the CHKPT macro 
instruction was issued. If any are found, 
they are deleted with the STOW macro 
instruction. 



Finally, the RESTORE macro instruction 
is used to reschedule any user I/O requests 
suspended by PURGE during execution of 
CHKPT. Control is then passed to the exit 
module. 



Exit Module (IGC0V05B) 

The exit module first tests an error 
code field in the work area to determine if 
entry is for an error termination. If an 
error code is found, message IHJ007I is 
issued. The exit module then issues an 
ABEND macro instruction to abnormally ter- 
minate the task. 

If no error has occurred, the exit 
module compares the sizes of the old task 
input/output table (TIOT) and current TIOT 
(which was saved in the RESTART work area) . 
If the current TIOT is smaller or equal to 
the old TIOT, it overlays the old TIOT, and 
the RESTART work area is freed. If the 
current TIOT is larger, it is moved to the 
end of the work area, and both the remaind- 
er of the work area and the old TIOT are 
freed. The exit module writes message 
IHJ008I to inform the operator that the job 
is being restarted. It then loads a com- 
pletion code of X f 04' into Register 15 to 
inform the problem program that it is being 
restarted, and issues an SVC 3 instruction 
to pass control to the problem program. If 
the program again abnormally terminates 
(and RESTART has not been deferred) , 
RESTART will again be attempted. 
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RECORDING/RECOVERY ROUTINES 



SER ROUTINES 

SERO is the less complex version of sys- 
tem environment recording • It determines 
the type of malfunction and, if possible , 
writes a record on the SYS1.LOGREC data set 
describing the error. SYS1.LOGREC is 
located on the primary system residence 
volume. If SERO cannot write the record, 
the computer is placed in a wait state and 
a message is printed requesting that the 
operator use system environment recording, 
edit, and print (SEREP). If SERO can write 
a partial or complete record, the computer 
is placed in a wait state, and a message is 
printed requesting that the operator reload 
the operating system. 

SER1 is the more complex version of sys- 
tem environment recording. It also 
collects and writes machine environment 
data, but in addition it attempts to asso- 
ciate the malfunction with the task being 
executed. If the malfunction can be asso- 
ciated with the task and if the control 
program has not been damaged, the task is 
abnormally terminated. If not, the comput- 
er is placed in a wait state. 

A message is issued to the operator when 
the SYS1.L0GREC data set is 90% full. The 
operator should then run the environment 
recording edit and print (IFCEREPO) service 
aid. IFCEREPO formats the SYS1.LOGREC rec- 
ords, and then writes the records onto 
printer, tape, or disk according to user 
specifications. IFCEREPO is described in 
the Service Aids Logic, Program Logic Manu- 
al . If the operator delays in "emptying" 
the SYS1.LOGREC data set, it may become 
full; when it does, a message will be 
issued to the operator. He must then run 
IFCEREPO immediately or system performance 
may be degraded. 



SERO CHART AG 

SERO collects, formats, and writes error 
information after a machine-check or a 
channel error has occurred. It is divided 
into two modules: IFBSR000, resident in 
the nucleus, and IFBSROxx (where xx is the 
model number: 40, 50, 65, or 75), located 
on the link library. This module is model 
dependent. The required modules are 
selected during system generation. 

Resident Module — IFBSR000 

Module IFBSR000 is nonreusable and does 
not require operating system facilities. 



It halts all I/O activity and then reads 
the first text record of module IFBSROxx 
into main storage (beginning 32 bytes past 
the end of the nucleus) . 

Module IFBSR000 saves information (in a 
22-byte field in lower storage) to be used 
later by IFBSROxx. After it has halted I/O 
activity on all devices, IFBSR000 attempts 
to read the first 1024 bytes of module 
IFBSROxx into main storage. If after ten 
retries, these 1024 bytes have not been 
read into main storage, IFBSR000 builds IOS 
wait state code 000F0A and then branches to 
the bell ring/wait state module which 
sounds the console alarm and places the 
computer in a wait state. Wait state code 
000F0A is displayed in the instruction 
counter. 

Link Library Module — IFBSROxx 

Like IFBSR000, module IFBSROxx does not 
require operating system facilities. 
IFBSROxx first loads the remainder of 
itself into main storage. It then checks 
location 50 to determine which type of mal- 
function has occurred, a machine- check 
error or a channel error. Location 50 is 
preassembled to X"FF". If the error is a 
machine-check error, location 50 will have 
been overlay ed by the machine- check old 
PSW. If the error is a channel error, 
location 50 remains unchanged. 

If the error is a machine- check error, 
IFBSROxx builds a machine-check record 
entry in which to place information about 
the error. If the error is a channel 
error, IFBSROxx builds a channel error rec- 
ord entry. 

Module IFBSROxx then enables machine- 
check interruptions. General registers are 
checked for valid parity on all models 
except Model 40. Parity indicators are 
available for all registers except 13, 14, 
and 15 on Models 50 and 75. Floating point 
registers are also checked for valid parity 
if the model is equipped with floating 
point. 

Module IFBSROxx checks the "busy bit" in 
each unit control block (UCB) to determine 
which I/O units were busy when the error 
occurred. The addresses of as many as ten 
busy I/O devices are collected. IFBSROxx 
then builds a record containing the program 
identification, job name, step name, day, 
and time. After examining the seek address 
obtained from the header record of the 
SYS1.LOGREC data set, IFBSROxx writes (on 
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that data set) the record it has just 
created and an end-of-file record. 

Module IFBSROxx then prints the follow- 
ing message to the operator: 

IFBF05W MACHINE ERROR. RELOAD OS/360 

This message indicates that a complete 
error record has been written on SYS1. 
LOGREC. If a message cannot be printed, 
IFBSROxx builds IOS display code 000F05 and 
branches to the bell ring/wait state 
module. 

If another machine-check interruption 
occurs while IFBSROxx is collecting data 
for an error record , IFBSROxx stops 
collecting data and attempts to write a 
partial error record on SYS1. LOGREC con- 
taining the data it has already collected. 
If it is able to do this, it prints the 
following message: 

IFBF06W MACHINE ERROR. RELOAD OS/360 

If a message cannot be printed, IFBSROxx 
builds IOS display code 000F06 and branches 
to the bell ring/wait state module. 

If another machine-check interruption 
occurs while IFBSROxx is attempting to 
write a partial error record, IFBSROxx can- 
not continue processing. It prints the 
following message: 

IFBF07S MACHINE ERROR. EXECUTE SEREP 

Other errors besides a machine-check 
interruption may prevent IFBSROxx from 
writing an error reocrd on SYS1. LOGREC. 
These errors (with the messages IFBSROxx 
prints to the operator) are as follows: 

1. An I/O error, 

IFBF08S MACHINE ERROR. EXECUTE SEREP 

2. SYS1. LOGREC data set is full, 
IFBF09S MACHINE ERROR. EXECUTE SEREP 

3. Module IFBSROxx could not be loaded 
into main storage, 

IFBFOAS MACHINE ERROR. EXECUTE SEREP 



the task that was executing. If it can do 
this , and if the control program is not 
damaged, SER1 abnormally terminates the 
task. The system continues to operate. 



If SER1 cannot write a complete error 
record or cannot associate the error with 
the task, or if the error damaged the con- 
trol program, the computer is placed in a 
wait state. The system must then be 
reloaded. 

SER1 checks location 50 to determine 
which type of malfunction occurred, a 
machine- check error or a channel error. 
Location 50 is preassembled to X"FF". If 
the error is a machine- check error, loca- 
tion 50 will have been overlayed by the 
machine- check old PSW. If the error is a 
channel error, location 50 remains 
unchanged. 

SER1 gathers error data into either a 
machine-check record or a channel error 
record and writes the record on SYS1. 
LOGREC. SER1 uses I/O routines provided by 
the operating system (it uses the EXCP 
macro instruction to communicate with the 
SYS1. LOGREC data set) unless the control 
program was damaged by the error. If the 
control program was damaged, SER1 uses its 
own I/O routines. The DEB and DCB required 
when EXCP is used reside in the nucleus and 
are opened by the nucleus initialization 
program (NIP) . 

If SER1 can associate the error with the 
task and if the control program is not 
damaged, SER1 terminates the task by 
branching to the ABTERM routine. When SER1 
regains control from ABTERM, it reinitial- 
izes itself and branches to the dispatcher 
so that the system can continue to operate. 

In order for the system to continue 
operating: 

• Another error cannot occur while SER1 
is collecting data for a previous 
error. If one does, SER1 stops 
collecting data and attempts to write a 
partial record of the original error on 
SYS1. LOGREC. The partial record con- 
tains the data collected before the 
second error occurred. 



SER1 CHART AH 

Like SERO, SER1 collects, formats, and 
writes error information after a machine- 
check or a channel error has occurred. 
Unlike SERO, it is a single, serially reus- 
able module that resides in the nucleus. 

In addition to writing error records, 
SER1 attempts to associate the error with 



• SER1 must be able to associate the 
error with the task that was executing. 

• The control program cannot be damaged 
by the error. 

If the system cannot continue operating, 
SER1 prints a message on the primary output 
device instructing the operator to reload 
the operating system. SER1 then places the 
system in a wait state. 
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E NVIRONMENT RECORDING AREA 

SYS1.LOGREC is a data set on the system 
residence device used exclusively by SERO r 
SER1, and all preservation recording sys- 
tems. It is formatted during system 
generation by utility program IFCDIPOO. 
The data placed in SYS1.L0GREC is edited 
and printed by the IFCEREPO (EREP) service 
aid. These programs are described in the 
Service Aids Logic § Program Logic Manual . 

SYSl.LOGREC contains three types of 
records : 

1. Header Record - This is the first 
record in the data set. It defines 
the extent of the data set, and 
addresses the last record written. It 
also contains a safety byte used to 
detect overrun. The record is 38 
bytes long. The format of the Header 



Record is described in the Input/ 
Output Supervisor , Program Logic 

Manual. 



2. Record Entry Area - This area begins 
immediately after the Header Record. 
It contains machine check records 
written by SERO, SER1, or the Machine 
Check Handler (MCH) ; channel check 
records written by SERO f SER1, or the 
Channel Check Handler (CCH) ; and unit 
check records written by the Outboard 
Recording routine (OBR) or the Miscel- 
laneous Data Recording routine. The 
formats of the unit check (outboard 
and miscellaneous data) records and 
the channel check (inboard) records 
are described in the I/O Supervisor, 
Program Logic Manual . The machine 
check record format is contained in 
Section 5 of this publication. 
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DEVICE INDEPENDENT DISPLAY OPERATOR CONSOLE SUPPORT (DIDOCS) ROUTINES 



This section contains a description of 
each of the Display Console Support rou- 
tines. These descriptions provide a gener- 
al explanation of each routine and 
references the applicable flowcharts. 



DIDOCS PROCESSOR ROUTINES 

The DIDOCS Processor routines (IGC5107B, 
IGC5Z07B, IGC6107B f and IGC6Z07B) receive 
control from MCS when an operator or system 
request is entered that requires processing 
by the DIDOCS routines. The following 
requests are processed by DIDOCS: 

• Open/Close request 

• Attention 

• I/O complete 

• DOM request 

• Hardcopy inoperative 

• Hardcopy operative again 

• Messages to be displayed 

• Timer interruption 

• Roll needed 



DIDOCS PROCESSOR 0, LOAD 1 (IGC6107B) 
CHART KA 

Procesor 0, Load 1 receives control from 
MCS to begin processing a request involving 
a display console with a transient DCM. 
Load 1 queues the request and then deter- 
mines if the transient portion of the DCM 
is required to process the request. If 
required, and if it is not already in main 
storage. Processor brings it into main 
storage. Control is then given to the Pro- 
cessor 1 routine (IGC5107B). 

Processor 0, Load 1 also checks for a 
request for a permanent PFK update (per- 
manent copies of PFK definitions are main- 
tained on SYS1.DCMLIB; the operator may 
make permanent changes to the definitions) . 
If a request for a permanent change is 
encountered. Processor 0, Load 1 builds the 
appropriate channel program and issues an 
EXCP macro instruction to initiate the 
change. When I/O is complete for a PFK 
update. Processor 0, Load 1 gives control 
to Processor 0, Load 2 to check for succes- 
sful I/O. 



When Processor is entered because an 
I/O operation is complete, control is given 
to Processor 0, Load 2 to determine if an 
I/O error occurred or if additional I/O 
processing is required. 

When Processor 0, Load 1 is entered from 
Load 2 (indicating that I/O is satisfaco- 
trily completed) , control is passed to Pro- 
cessor 1. 



DIDOCS PROCESSOR 0, LOAD 2 (IGC6Z07B) 
CHART KB 

Processor 0, Load 2 receives control 
from Processor 0, Load 1 when an I/O opera- 
tion is signaled complete. Load 2 deter- 
mines if any additional I/O processing is 
required and if any I/O errors occurred. 
Action is taken as follows: 

• I/O Error — Writes an error message to 
the operator" s console and passes con- 
trol back to MCS with an indication 
that a console switch is required. 

• Additional I/O necessary — Updates and 
executes the channel program. 

• I/O Complete — Passes control to Pro- 
cessor 0, Load 1. 



DIDOCS PROCESSOR 1, LOAD 1 (IGC5107B) 
CHART JA 

DIDOCS Processor 1, Load 1 receives con- 
trol be begin processing an operator or 
system request. Control is received either 
directly from MCS (when the console 
involved in the request does not have a 
transient DCM) or from the Processor rou- 
tine (when the console has a transient DCM). 

Processor 1, Load 1 determines the 
reason for entry and passes control to the 
appropriate display console support rou- 
tine. Figure 43 summarizes the major 
reasons for entry to the DIDOCS Processor 
routine, the resulting exit, and the reason 
for the exit. In addition, the module 
functions as a controller for DIDOCS, 
prioritizing functions and returning con- 
trol for functions which are not yet 
complete . 

When DIDOCS has nothing to do for a par- 
ticular console, or the device is busy. 
Processor 1, Load 1, returns to MCS (BR 
14) , possibly through 'Processor if the 
DCM is transient. 
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Reason for Entry 

Open/Close request 

Reopen request 

I/O error 

DOM issued 

Hardcopy down/ 
recovered 

Messages to be 
displayed 

Timer interruption 

Roll needed 

Read complete 

Attention 

Cancel 

PFK attention 

Enter 

Light pen, or cursor 
not in entry area 



Exit 
Open/Close Routine 
I/O Routine 

Asynchronous Error Routine 
Delete 2 Routine 
Message 1 Routine 

Display 1 Routine 

Timer Interpreter Routine 
Roll Mode Routine 
Command Routine 
I/O Routine 

Command Routine 

PFK 1 Routine 

I/O Routine/Command Routine 

Light Pen/Cursor Routine 



Reason for Exit 

Open/Close I/O blocks 

Initialize DCM 

Handle I/O error 

Mark messages for deletion 

Provide/remove no hard copy 
message 

Display messages 

Analyze timer interval 

Perform roll 

Handle command read- in 

Read Manual Input to determine 
type 

Restore entry area 

Process commands 

Read command if necessary 

Interpret desired function 



Figure 43. DIDOCS Processor Routine Entries 



DIDOCS PROCESSOR 1. LOAD 2 (IGC5Z07B) 
CHART JB 

Processor 1, Load 2 receives control 
from Processor 1, Load 1 for processing 
close requests and for continued processing 
of request parameter lists. 



If entry is for processing a close re- 
quest, Processor 1, Load 2 determines 
whether the screen has been erased. If it 
has not, flags are set in the DCM and con- 
trol is passed to the device-dependent I/O 
routine to erase the screen. If the screen 
has been erased, control is passed to the 
Open/Close routine to complete processing 
of the close request. 



If entry is for processing of a request 
parameter list, the type of request is 
determined and control is passed to the 
appropriate display console support routine 
(this process is a continuation of the re- 
quest handling process begun in Processor 
1, Load 1). If the request in the paramet- 
er list has already been processed, control 
is returned to Processor 1, Load 1. 



OPEN/CLOSE ROUTINE (IGC5G07B) CHART KK 

The Open/Close routine determines wheth- 
er to open or close a device by checking a 
parameter passed to it in the communica- 
tions task extended save area (CXSA) . 

After opening a DCB, control is returned 
either to the DIDOCS Processor, if a con- 
sole exists, or to the MCS Console Switch 
routine, if there is no console. After 
closing a DCB, control is returned to the 
Cleanup routine. 



2250 I/O 1 ROUTINE (IGC5P07B) CHART JC 

The 2250 I/O 1 routine performs 
requested I/O operations. It checks the 
communication bytes in the DCM (I/O com- 
munication bytes 1, 2, and 3 and message 
communication byte 1) to determine the type 
and format of I/O requested. 

Each I/O request is checked and the 
appropriate CCWs are built until all the 
I/O requests are set up in the channel pro- 
gram. This routine builds CCWs for the 
following I/O requests: 
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• Read manual input (RMI) 

• Write 'message waiting' message 

• Write message area 

• Write instruction line 

• Sound alarm 

• Write entry area 

• Write warning line 

• Insert cursor 

If a light pen interruption occurs, con- 
trol is passed to the Light Pen/Cursor rou- 
tine (IGC5F07B). If one of the following 
I/O operations is requested, control is 
passed to the 2250 I/O 2 routine: 

• Write asynchronous error message 

• Write message; message waiting 

• Write status display 

• Erase screen 

• Sound alarm 



For all other cases, control passes to the 
DIDOCS Processor (IGC5107B). 



2250 I/O 2 ROUTINE ( IGC5Q07B) CHART JD 

The 2250 I/O 2 routine is called by the 
2250 I/O 1 routine to process one or more 
of the following I/O requests by building 
the required CCWs: 

• Write asynchronous error message 

• Write status display 

• Erase screen 

• Read entry area 

• Write PFK lines 

• Light PFK keys 



This routine also initializes the instruc- 
tion line, and blanks the entry area, and 
warning line as requested prior to perform- 
ing I/O in these areas. 

This routine also picks up the channel 
program address from DCMDSAV. The exit 
from this routine is to the DIDOCS Proces- 
sor (IGC5107B). 



2260 I/O 1 ROUTINE (IGC5R07B) CHART JE 

The module first tests for a status 
switch request. If this is indicated, con- 
trol is passed to the 2260 I/O 2 routine 
(IGC6R07B). The 2260 I/O routine then 
checks bits set in the DCM to determine 
which I/O operation is to be performed. 
One of three possible I/O operations may be 
requested: (1) read manual input (RMI) to 
find cursor, (2) write screen, or (3) read 
entry area. This routine normally exits to 
the DIDOCS Processor routine (IGC5107B) 
unless the cursor is located adjacent to 
the start of message (SOM) symbol and the 
screen is in "hold" mode. In the latter 
case, the CANCEL function is to be per- 
formed and the 2260 I/O routine exits to 
the Command routine (IGC5407B) . If the 
cursor is not located in the entry area, 
the line and character positioning is com- 
puted and exit is to the light pen/cursor 
routine (IGC5F07B) . 



2260 I/O 2 ROUTINE (IGC6R07B) CHART JF 

This routine is entered from 2260 I/O 
routine 1 when a change in a 2260 console's 
operating mode is requested by the operator 
or required by the system. IGC6R07B is 
called twice during each console switch. 
On the first pass, the routine determines 
the new console operating mode (full capa- 
bility or output only) and passes control 
to the DIDOCS Cleanup routine (IEECVFTG) to 
continue processing of the console mode 
switch. 

When IGC6R07B receives control for the 
second time during a console switch, the 
routine determines if "message stream" mode 
has been requested. If so, the routine 
sets a "roll delete" mode indicator in the 
DCM (this places the console in "roll- 
deletable" mode for message deletion) and 
exits to the Timer/Interpreter routine 
(IEECVETK) to continue processing of the 
console mode switch. If message stream 
mode was not requested, control is returned 
to 2260 I/O 1 (IEECVETR) to complete pro- 
cessing of the console mode switch request. 



MODEL 85 I/O ROUTINE (IGC5H07B) CHART JG 

The module first tests for a status 
switch request. If this is indicated, con- 
trol is passed to the Cleanup routine 
(IGC6G07B). The Model 85 I/O routine then 
checks the communication bytes in the DCM 
(I/O communication bytes 1, 2, and 3 and 
message communication byte 1) against pre- 
established bit settings to determine the 
type and format of I/O requested. 

Each I/O request is checked and the 
appropriate CCWs are built until all the 
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I/O requests are set up in the channel pro- 
gram. This routine builds CCWs for the 
following I/O requests: 



Read manual input (RMI) 

Read entry area 

Write message area 

Write asynchronous error message 

Write message waiting message 

Write status display 

Write instruction line 

Write entry area 

Write warning line 

Insert cursor 

Blank warning line 

Blank instruction line 

Blank entry area 

Erase screen 

Sound alarm 



Control is returned to the DIDOCS Processor 
(IGC5107B). 



ASYNCHRONOUS ERROR ROUTINE (IGC5C07B) 
CHART KC 

The Asynchronous Error routine handles 
asynchronous errors and reopen conditions. 
For permanent synchronous or asynchronous 
errors, this routine performs console 
switching by exiting to the MCS Console 
Switch routine (IGCXL07B). 



When an asynchronous error occurs, the 
Asynchronous Error routine sets indicators 
in the DCM to erase the screen and display 
an error message. These indicators are set 
for the Message 2 routine (IGC5E07B), which 
moves the appropriate error message into 
the DCM, and for the appropriate device I/O 
routine which erases the screen and writes 
the error message. Control is passed to 
the Message 2 routine (IGC5E07B) . 

When a reopen condition is met, this 
routine initializes the DCM and passes con- 
trol to the appropriate device I/O routine 
to write the screen. 



MESSAGE 1 ROUTINE (IGC5D07B) CHART JH 

The Message 1 routine contains messages 
used by Display Console Support. It tests 
bit settings in the DCM to determine which 
message to move into the screen- image buff- 
er while distinguishing between error and 
warning messages. This routine then sets 
indicators in the DCM to write the screen. 
Message 1 sets the sound alarm bit unless 
an UNVIEWABLE MESSAGE or DELETION REQUESTED 
warning message is written. If the bit 
settings in the DCM indicate that a message 
is to be written, the Message routine moves 
the message into the DCM and exits to the 
appropriate device I/O. Otherwise, control 
passes to the DIDOCS Processor (IGC5107B). 



MESSAGE 2 ROUTINE (IGC5E07B) CHART JI 

The Message 2 routine contains the asyn- 
chronous error and deletion request error 
messages used by Display Console Support. 
It tests bit settings in the DCM to deter- 
mine which messages to move into the screen 
image buffer. This routine then sets indi- 
cators in the DCM to write the screen, sets 
the sound alarm bit, and exits to the 
appropriate device I/O routine. 



MESSAGE ROUTINE 3 (IGC6D07B) CHART J J 

The Message 3 routine contains the PFK 
support error messages used by Display Con- 
sole Support. Message 3 tests bit settings 
in the DCM to determine which messages to 
move into the screen image buffer (in the 
DCM) . It then sets indicators in the DCM 
to write the screen, sets the sound alarm 
bit, and exits to the appropriate device 
I/O routine. 



DISPLAY 1 ROUTINE (IGC5207B) CHART JK 

Display 1 displays all operating system 
messages except those to be deleted (unless 
DEL=N) and status display messages. It 
searches the output queue for write queue 
elements (WQEs) to be displayed. If this 
search is successful, control is passed to 
Display 3. Upon return from Display 3, 
Display 1 exits to the appropriate device 
I/O routine. 

If a status display is overlaying mes- 
sages on the screen. Display 1 exits to 
either Delete 2 (IGC5707B) , in case an 
intervention required action message is on 
the screen, or Delete 4 (IGC5907B), if 
there are no action messages and automatic 
deletion is specified and not yet tried. 
If automatic deletion is not specified or 
has been tried, this routine exits to eith- 
er Message 1 (IGC5D07B) to display an 
UNVIEWABLE MESSAGE or the appropriate 
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device I/O routine to display a MESSAGE 
WAITING. If roll mode is specified, Dis- 
play 1 exits to Display 2 (IGC5307B) to set 
the timer as required. If a message is too 
long or an accepted reply is on the screen. 
Display 1 exits to Display 2 (IGC5307B) . 
When no messages are added to the DCM, Dis- 
play 1 returns control to MCS via a branch 
on register 14. 



DISPLAY 2 ROUTINE (IGC5307B) CHART JL 

The Display 2 routine splits messages 
longer than 72 characters (70 for the 
2250) , or marks all accepted replies and 
associated WTORs as automatically deletable 
in the screen- image buffer. In the latter 
case. Display 2 sets the timer as required. 
After line splitting. Display 2 exits to 
Display 1 (IGC5207B) . It exits to one of 
the following routines if marking accepted 
replies is performed: 

• Delete 2 routine (IGC5707B) to delete 
intervention required action messages. 

© Delete 4 routine (IGC5907B) to perform 
automatic deletion. 



roll. Control is passed to the Timer 
Interpreter (IGC5K07B) unless DEL=RD and no 
deletable messages are on the visible por- 
tion of the screen; in that case, control 
is passed to the appropriate device I/O 
routine to write the message- waiting 
message. 

The RNUM value specified in the CONTROL 
S command determines the number of lines 
the Roll Mode routine removes, unless one 
of the following exceptions exists: 

• Fewer lines are on the output queue 
than the RNUM value (less lines 
rolled) . 

• The number of lines displaced by a sta- 
tus display is smaller than RNUM value 
(less lines rolled). 

• Roll Deletable (RD) was mode specified 
and the number of deletable lines on 
screen is smaller than the RNUM value 
(less lines rolled) . 

• The top line on screen following the 
roll is a continuation line (one more 
line rolled) . 



o Device- dependent I/O routine to perform 
input/output . 

a Message 1 routine (IGC5D07B) to write 
UNVIEWABLE MESSAGE warning. 

• DIDOCS processor (IGC5107B) to continue 
processing. 



DISPLAY 3 ROUTINE (IGC6207B) CHART JM 

Display 3 uses the WQEs found by Display 
1 to place the message (s) into the next 
available line in the screen image buffer 
of the DCM. It marks each message accord- 
ing to its descriptor code as provided by 
MCS and returns control to DISPLAY 1. 



ROLL MODE ROUTINE (IGC5J07B) CHART JN 

The Roll Mode routine performs the roll 
function when messages are on the WQE and 
the time specified for roll expires. When 
messages on a display console are ready to 
be rolled, the routine rolls the messages 
in the screen image buffer. If the CONTROL 
command operand DEL is set to roll delet- 
able (RD) mode, the specified number of 
deletable messages are removed. If DEL is 
set to roll (R) mode, the specified number 
of messages, including action messages, are 
removed. It also stores the information 
for inserting the number of message lines 
remaining on the output queue into the 
first two character positions of the first 
new message to be displayed following a 



COMMAND ROUTINE (IGC5407B) CHART JO 

The Command routine analyzes the com- 
mands in the entry area, processes CANCEL 
attentions, and processes requests to 
remove message numbers. According to the 
reason for entry, the routine takes the 
following action: 

• CANCEL attention: the Command routine 
sets flags, alters the DCM as appropri- 
ate, and then passes control to the 
appropriate I/O routine. 

• CONTROL command (with no other 
operands) : the Command routine passes 
control to the Delete 3 routine to 
erase a segment of messages from the 
screen. 

• Delete verification: the Command rou- 
tine passes control to the Delete 4 
routine to process the deletion 
verification . 

• CONTROL commands: the Command routine 
issues SVC 34 to pass the command to 
the system's command processing rou- 
tines. Upon return from SVC 34, the 
Command routine determines if a para- 
meter list was provided by the SVC 34 
routines. If not, the Command routine 
blanks the entry area and passes con- 
trol to the appropriate I/O routine. 
If a parameter list was provided, and 
the command in the entry area was CON- 
TROL E,N, the Command routine erases 
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the message numbers from the screen and 
passes control to the appropriate I/O 
routine. For all other commands, the 
Command routine passes control to the 
routine indicated in the SVC 34 para- 
meter list. 

All other commands : the Command rou- 
tine issues SVC 35 to write the command 
to the message area of the console 
screen, and then issues SVC 34 to pass 
the command to the system's command 
processing routines. Upon return from 
SVC 34, the Command routine determines 
if a parameter list was provided. If 
not, the Command routine blanks the 
entry area nnd passes control to the 
appropriate I/O routine. If a paramet- 
er list was provided, the Command rou- 
tine passes control to the routine 
indicated in the parameter list. 



preter with instructions to pass control to 
the Message 1 routine when finished. 



DELETE 1 ROUTINE (IGC5607B) CHART JQ 

Delete 1 handles the erase commands CON- 
TROL E,F and CONTROL E,nnC,nn]. If conver- 
sational mode is in effect. Delete 1 
updates the screen-image buffer by marking 
and numbering those messages selected for 
deletion, and passes control to Message 1 
(IGC5D07B) to write the DELETION REQUESTED 
message. If nonconversational mode is in 
effect, Delete 1 updates the screen image 
buffer by marking and numbering those mes- 
sages to be deleted, and passes control to 
Delete 4 (IGC5907B) for immediate deletion. 
Delete 1 exits to Message 2 (IGC5E07B) if 
the erase command is inconsistent, or if it 
has an invalid operand. 



OPTIONS ROUTINE (IGC5A07B) CHART JP 

The Options routine receives control 
from the Command routine to analyze the 
minor operand values (DEL, CON, SEG, RNUM, 
RTME) of the CONTROL command specification 
(S) operand. If these minor operands and 
their respective values are valid, the 
Options routine changes the current values 
accordingly and indicates the screen 
options in effect. If these minor operands 
and/or their values are not valid, this 
routine exits to the appropriate device I/O 
routine with instructions to write the 
appropriate message from the Message rou- 
tine. The Options routine also displays 
all the current screen option values when 
requested by the CONTROL 
S [ , REF ] command . 

• CON=N and no hard copy 

• DEL=R or RD and no hard copy 

• DEL=R or RD and no timer 

If a warning message is required, this rou- 
tine sets the appropriate indicators and 
continues processing. If an error message 
is required, the Options routine exits to 
the Message 1 routine (IGC5D07B). 

Upon preparing to exit, the Options rou- 
tine indicates the proper location of the 
cursor. If a warning message is to be dis- 
played, this routine transfers control to 
Message 1 (IGC5D07B) . If the value of DEL 
is changed to or from R or RD, or if the 
RTME operand has been changed, the Options 
routine sets an indicator bit in the DCM 
and exits to the Timer Interpreter routine 
(IGC5K07B) . If a warning or error message 
is required, and a return to the Timer 
Interpreter routine is also indicated, the 
Options routine exits to the Timer Inter- 



DELETE 2 ROUTINE (IGC5707B) CHART JR 

The Delete 2 routine handles the dele- 
tion of intervention-required action mes- 
sages and messages indicated for deletion 
by the DOM macro instruction. Delete 2 
marks as automatically deletable those mes- 
sages successfully acted upon or indicated 
for deletion by the DOM macro instruction, 
if the display device is not busy or a 
delete request is pending. If the device 
is busy or a delete request is pending. 
Delete 2 passes control to the MCS Router 
routine (IGCXL07B) . Delete 2 marks all 
intervention required action messages as 
automatically deletable and passes control 
to the DIDOCS Processor (IGC5107B) if a 
delete request is pending. Otherwise, 
Delete 2 passes control to either Delete 4 
(IGC5907B) if automatic deletion is 
desired, or to the appropriate device I/O 
routine to write the message area when 
automatic message deletion is not 
specified. 



DELETE 3 ROUTINE (IGC5807B) CHART JS 

Delete 3 handles the erase command CON- 
TROL [E,SEG] and deletion by cursor or 
light pen. It updates the screen image 
buffer by marking and numbering the message 
area segment for deletion. If conversa- 
tional mode is in effect. Delete 3 passes 
control to Message 1 (IGC5D07B) to write 
the appropriate message on the instruction 
line requesting operator verification of 
the messages marked for deletion. If non- 
conversational mode is in effect. Delete 3 
passes control to Delete 4 (IGC5907B) for 
immediate deletion. If the value of SEG is 
0, or if there are no deletable messages 
within the message area segment. Delete 3 
exits to Message 2 (IGC5E07B) to display 
the appropriate error message. 
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DELETE 4 ROUTINE (IGC5907B) CHART JT 

Delete 4 examines the message indicators 
in the screen control table in the DCM and 
blanks those lines in the screen image 
buffer marked for automatic or regular 
deletion, while it moves nondeletable lines 
up to the first available message line. 
This routine also handles the command CON- 
TROL D,N[,HOLD] by numbering all visible 
message lines. 

If the deletion of messages is success- 
ful when a status display is not on the 
screen and a full screen condition exists. 
Delete 4 returns control to Display 1 
(IGC5207B). Otherwise, Delete 4 exits to 
either Message 1 (IGC5D07B) to display a 
message informing the operator that unview- 
able messages are on the output queue if 
the screen is not yet full, or to the 
appropriate device I/O routine to display 
the MESSAGE WAITING warning message and 
write the entire screen. 



LIGHT PEN/CURSOR ROUTINE (IGC5F07B) 
CHART JU 

The Light Pen/Cursor Service routine 
handles light pen and cursor interruptions. 
If a light pen or cursor delete request 
occurs on the message line of a non-action 
message or on the asterisk of an action 
message, the routine transfers control to 
Delete 4 (IGC5907B) or Delete 3 (IGC5807B), 
depending on whether delete verification is 
indicated. If a light pen detect or cursor 
placement is on *ENTER* in the instruction 
line, this routine passes control to the 
appropriate device I/O routine to perform a 
READ operation. When the light pen or cur- 
sor is positioned on * CANCEL* in the 
instruction line (to cancel a request) or 
on *E* in the status display title line (to 
erase a status display) , the Light Pen/ 
Cursor Service routine passes control to 
the Command routine (IGC5407B) . When the 
light pen or cursor is positioned on *D 
C,K* in the instruction line or *F* in the 
status display title line, control passes 
to the Command routine. If the light pen 
is positioned in the PFK line, exit is to 
PFK 1 (IGC6A07B). If the light pen or cur- 
sor is positioned on any location other 
than those mentioned above, an error 
exists. Control is passed to Message 1 
(IGC5D07B) or Message 2 (IGC5E07B) to dis- 
play the appropriate error message. 



PFK ROUTINE 1 (IGC6A07B) CHART KL 

PFK 1 receives control from Processor 1, 
Load 1 when a PFK is pressed or when a PFK 
key has been verified and there are more 
commands or keys to be processed. It also 
receives control from the Light Pen/Cursor 



routine when a light pen interruption 
occurs for a number displayed in the PFK 
display line. 

If entry is to cancel a PFK request, the 
commands associated with the canceled PFK 
key are removed from the entry area of the 
DCM. Also, control information is removed 
from the PFK area of the DCM so that later 
use of the same PFK key will cause new 
copies of the definitions to be used. 

If entry is to enter a command, the 
number of the key is placed in the DCMPFKNM 
field of the DCM, and the routine checks to 
see if the key is valid. If it is not, 
exit is made to Message Module 1 so that an 
error message can be issued. Otherwise, a 
check is made to see if the key is already 
in process (a key may have several commands 
associated with it, each of which must be 
processed separately) . If the key is not 
in process, it is flagged as in-process- 
now, and a check is made to see if the key 
is defined as a list of key numbers. If it 
is, control is returned to the entry point 
of the routine (PFK 1) so that each key 
number in the list can be processed 
separately. 

When the routine determines that a key 
number in the list is associated with a 
command to be processed, the command is 
moved to the entry area buffer in the DCM. 
If the key is in conversational mode, the 
command is written to the screen where the 
operator may cancel or accept it. If the 
key is not in conversational mode, the com- 
mand is executed by simulating an operator 
ENTER action. 

After all commands have been processed, 
the PFK work area is cleaned up and control 
is returned to the Processor 1 routine. 



PFK ROUTINE 2 (IGC6B07B) CHART KM 

PFK 2 receives control from the Proces- 
sor 1 routine when entry is made to rede- 
fine a PFK or to write or erase the PFK 
display line (the line of the display con- 
sole screen containing PFK key numbers 
which may be entered by light pen 
selection) . 

The routine first determines which func- 
tion is requested. If the request is to 
erase or display the PFK display line, exit 
is made to the I/O for the device for which 
the display is requested. If the request 
is to redefine a PFK, the routine scans the 
new command and, if no errors are encoun- 
tered, replaces the old definition with the 
new. Control is then returned to the Pro- 
cessor 1 routine. 
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TIMER INTERPRETER (IGC5K07B) CHART JV 

The Timer Interpreter analyzes the timer 
intervals at which each of the display con- 
sole devices specifying roll mode is sched- 
uled to be rolled, and sets indicators to 
notify the Roll Mode routine (IGC5J07B) 
whenever the timer interval has elapsed for 
one or more of the display console devices. 



The routine initially stores the timer 
interval (RTME if roll mode is specified, 
if not) for each display console device in 
its respective DCM. The greatest common 
divisor (GCD) of all the non-zero timer 
intervals is constantly updated as new 
devices are added as display consoles. The 
Timer Interpreter routine sets the timer 
equal to the GCD. 



Whenever the timer elapses, this routine 
adds the GCD to the time counter of each of 
the display console devices whose timer 
interval is not equal to 0. If the new 
total equals or exceeds the timer interval 
for one or more display console devices, 
the Timer Interpreter notifies the DIDOCS 
Processor routine (IGC5107B) that the mes- 
sages on each of these devices are ready to 
be rolled. 



The Timer Interpreter gets control for 
one of three reasons. First, if control is 
passed from the DIDOCS Processor,, the timer 
has elapsed, in which case it returns to 
the DIDOCS Processor. Second, if the rou- 
tine gets control from the Options routine, 
the Open-Close routine, or the Asynchronous 
Error routine, the GCD needs to be updated 
for a new set of intervals. Control is 
passed from the Options routine when a dis- 
play device is put into or taken out of 
roll mode, or the value of RTME is changed, 
in which case an exit is taken to the 
appropriate device I/O routine or one of 
the message routines. Entry is from the 
Open/Close routine when a display device in 
roll mode is removed as an operator's con- 
sole; control returns to the Open/Close 
routine (IGC5G07B) . Entry is from the 
Asynchronous Error routine in order to set 
a single timer interval of 30 seconds for 
the removal of the error message; exit is 
to the Message 2 routine (IGC5E07B). 
Third, the routine gets control from the 
Roll Mode routine (IGC5J07B) to insert in 
the first two character positions of the 
first new message the number of message 
lines remaining on the output queue. The 
Timer Interpreter then exits to the appro- 
priate device I/O routine if the warning 
message bit is on. Otherwise, the Timer 
Interpreter passes control to the Display 1 
routine. 



STATUS DISPLAY INTERFACE 1 ROUTINE 
(IGC6L07B) CHART KD 



This routine receives control from the 
Processor routine (IGC5107B) or Display 3 
(IGC6207B) to process multiple- line WTO 
messages that do not have descriptor codes 
8 and 9 (descriptor codes 8 and 9 indicate 
that a display is a response to an opera- 
tors request and is to be presented out- 
of-line, in a display area of a display 
console) . 

Upon initial entry, the routine sets a 
flag in the UCM indicating that a status 
display is in progress. This flag insures 
that all of the lines of the status display 
will be displayed contiguously to prevent 
interleaving of other messages with the 
lines of the status display. The routine 
then moves lines of the WTO into the DCM 
until a sufficient number of lines have 
been passed to fill the screen or until the 
last line is encountered. If the screen 
becomes full before the last line is 
encountered, exit is made to the device 
dependent I/O routine to issue a MESSAGE 
WAITING message. When the last line is 
passed to the DCM, the WQE turns off the 
multiple-line WTO flag in the UCM and 
checks the WQE buffer for additional mes- 
sages to be processed. If any are found, 
control is passed to the Display 3 routine 
(IEECVFT2) for further processing. Other- 
wise, control is passed to the I/O routine 
to display the messages that were moved to 
the DCM. 



STATUS DISPLAY INTERFACE 2 ROUTINE 
(IGC6M07B) CHART KE 

This routine receives control from the 
processor routine (IGC5107B) to process 
requests for multiple- line WTO messages 
that have descriptor codes 8 and 9 (these 
codes indicate that the message is a status 
display requested by the operator, and that 
the display is to be presented out-of-line 
in a display area on a display console 
screen) . This routine functions as a con- 
troller for Status Display Interface rou- 
tines 4 and 6. 

Upon initial entry, the routine searches 
the console output queue for a WQE repre- 
senting a multiple- line WTO. When one is 
found, the routine locates in the DCM the 
screen area control block (SACB) for the 
display area in which the display will 
appear. If the WQE represents a new dis- 
play, the SACB is initialized, and any sta- 
tus display in the area is dequeued. If 
the display area is now empty (that is, it 
contains no other operator messages), con- 
trol passes to the Status Display Interface 
6 routine (IGC6O07B), which puts as many 
lines as possible of the message into the 
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screen image buffer (in the DOM) . If the 
display will overlay other operator mes- 
sages, control passes to Status Display 
Interface 4, which sets up a write- area. 
This separate write-area will be used by 
the I/O routines to write the display to 
the screen (this avoids using the DCM 
screen image buffer as a write-area, which 
would destroy the overlaid operator mes- 
sages) . If message area lines below the 
display area in use require blanking, con- 
trol is passed to the Status Display Inter- 
face 5 routine (IGC6P07B) . 



STATUS DISPLAY INTERFACE 3 ROUTINE 
(IGC6N07B) CHART KF 

This routine receives control from the 
Processor routine (IGC5107B) to process 
CONTROL commands affecting out-of-line sta- 
tus displays (K D,H? K D,U; K D,F). 

If entry has been made for processing 
CONTROL commands, the routine takes action 
according to the operands of the command: 

• K D,H — an internal PM A is issued to 
stop the time interval updating of the 
display. The display remains in the 
screen but the routine rewrites the 
control line to contain frame and upd- 
ate options. 

• K D,U — an internal MN A is issued to 
continue updating the display. The 
control line is rewritten to contain 
stop and hold options. 

• K D,F — a control line containing the 
new frame number is built in the write 
area and control is passed to the I/O 
routine to write the new frame. 



STATUS DISPLAY INTERFACE 5 ROUTINE 
(IGC6P07B) CHART KH 

This routine is entered from the Proces- 
sor routine (IGC5107B) to process CONTROL 
commands affecting out-of-line status dis- 
plays (K E,D; PM A). Action is taken as 
follows : 

• K E r D — the appropriate major and 
minor WQEs are removed from the queue, 
and control is passed by means of the 
XCTL macro instruction to the I/O rou- 
tine, which erases the display from the 
screen. 

• PM A — the dynamic display indicator 
in the DCM is turned off, the appropri- 
ate WQEs are removed from the queue, 
and control is passed to the I/O rou- 
tine, which erases the display from the 
screen. 



STATUS DISPLAY INTERFACE 6 ROUTINE 
(IGC6Q07B) CHART KI 

This routine is entered from the Status 
Display Interface 2 routine (IGC6M07B) to 
move lines of a status display from the WQE 
into the appropriate message area lines of 
the screen image buffer (in the DCM) . This 
routine is entered only if the status dis- 
play does not overlay any other operator 
messages. 

On entry, this routine moves lines from 
the WQE into the screen image buffer until 
the display area is filled. When all lines 
of the display have been moved, any lines 
remaining in the display area are blanked, 
and the control line is rewritten to indic- 
ate FRAME LAST. 



STATUS DISPLAY INTERFACE 4 ROUTINE 
(IGC6O07B) CHART KG 



STATUS DISPLAY INTERFACE 7 (IGC6T07B) 
CHART KJ 



This routine receives control from the 
Status Display Interface 2 routine 
(IGC6M07B) to move lines of a status dis- 
play from the WQE into a temporary write 
area in the DCM. This routine is entered 
only for status displays that overlay other 
operator messages on a display console 
screen. 

This routine uses the instruction line 
and the two lines of the entry area as the 
temporary write area. It moves three lines 
of the message into this temporary write 
area, and then exits to the I/O routine to 
write the lines to the screen. When the 
last line of the display is put into the 
temporary work area, the routine blanks any 
remaining display area lines 3 lines at a 
time and puts the FRAME LAST indicator in 
the control line. 



This routine receives control from Sta- 
tus Display Interface 5 (IGC6P07B) to blank 
message area lines below a status display 
that is being displayed in a display area. 

Upon entry, this routine determines the 
number of lines that require blanking and 
locates the first line to be blanked. It 
then fills the instruction line and the 
entry area (in the DCM) with blanks. After 
these lines are blanked, control is passed 
to the device-dependent I/O routine to 
blank the first three lines that require 
blanking. The I/O routine uses the three 
lines as a write area to write blanks to 
the screen. (This procedure prevents the 
message area from being broken up into 
blocks of general message traffic and 
blocks of status displays. It also allows 
any messages that were overlayed with 
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blanks to remain untouched in the DCM 
screen image buffer. When the status dis- 
play is erased, the screen is again written 
from the screen image buffer, and the mes- 
sages reappear.) 



CLEANUP ROUTINE (IEECVFTG) CHART KN 

This routine receives control from the 
OPEN/CLOSE routine when a request for clos- 
ing a device has been entered; it also 
receives control from the Asynchronous 
Error routine when a request to vary con- 
sole status has been entered or when a 
device is recovering from an asynchronous 
error. This routine removes status dis- 
plays from the message queues, and reini- 
tializes the screen area control blocks 
(SACBS) . 

Upon entry, this routine determines the 
reason for entry and then determines if the 
console involved in the entry has a MONITOR 
Active display in "update" mode. If so, 
the display is stopped (STOPMN) . The rou- 
tine then searches the console's SACBs for 
partially output status displays. If any 
are found, they are freed. The routine 
then takes the following action according 
to the reason for entry: 



• CLOSE — the SACB configuration is re- 
initialized to the value specified dur- 
ing system generation, all messages are 
removed from the queue, and control is 
passed to Processor 1. 

• Change in status to SD — inline mes- 
sages are freed, the SACBs are re- 
initialized to the values specified 
during system generation, and control 
is passed to the Asynchronous Error 
routine (IEECVETC). 

• Change in status to MS — the SACB con- 
figuration is reinitialized to the 
values specified during system genera- 
tion, all SACBs are marked as unused, 
and control is passed to the Asynch- 
ronous Error routine (IEECVETC) . 

o Change in status to FC — the SACB con- 
figuration is reinitialized to the 
values specified during system genera- 
tion, and control is passed to the 
Asynchronous Error routine (IEECVETC) . 

• Asynchronous Error recovery — out-of- 
line displays in progress and on the 
output queue are freed, the SACB confi- 
guration is retained, and control is 
passed to the Asynchronous Error rou- 
tine (IEECVETC). 



Device Independent Display Operator Console Support (DIDOCS) Routines 143 



SPECIAL FEATURES 



EXTENDED PRECISION FLOATING POINT SIMULATOR 
ROUTINES 

IEAXPSIM 

The SPIE user routine passes in register 
1 the address of a pointer to a doubleword 
area. IEAXPSIM determines from the field 
CVTOPTA (offset X , 182.7 f ) in the CVT wheth- 
er the extended precision floating-point 
feature is supported by CPU hardware. If 
so, IEXPSIM moves the name of the module 
IEAXPDXR into the doubleword area; if not f 
the module name IEAXPALL is moved into the 
area. The user routine uses this name to 
bring the appropriate processing module 
into main storage. 

IEAXPALL 

The user SPIE routine passes in register 
1 the address of a parameter list contain- 
ing the address of the PIE, the address of 
the register save area (containing the con- 
tents of the registers at the time of the 
interruption) , a pointer to a 4 00 -byte work 
area, and a pointer to a byte of main 
storage. If this byte of main storage is 
not r the validity of the low order bit of 
the result of a DXR instruction has not 
been ensured. IEAXPALL examines the opera- 
tion code and register specifications of 
the failing instruction pointed to by the 
program check old PSW. If any of these are 
invalid, an appropriate code and error 
indicator are returned to the caller. For 
the MXD instruction, IEAXPALL also issues a 
SPIE macro instruction to intercept any 
interruptions caused by invalid addressing. 

IEAXPALL then performs the necessary 
computation and indicates any exceptional 
conditions encountered during computation. 
For AXR and SXR instructions, the condition 
code is set in the Old PSW in the PIE. A 
code in register 15 and an indicator in 
bits 28-31 of the PSW in the PIE are 
returned to the caller. 



Code Indicator 
FF 5 



FF 



FF 



FF 



FF 



FF 



IEAXPDXR 



Meaning 

Addressing exception 
encountered during simula- 
tion of an MXD instruc- 
tion; operation 
suppressed. 

Specification exception 
encountered during simula- 
tion of an MXD instruc- 
tion; operation 
suppressed. 

Exponent overflow encoun- 
tered; operation 
completed. 

Exponent underflow encoun- 
tered; operation 
completed. 

Significance exception 
encountered; operation 
completed. 

Floating-point divide 
exception encountered; 
operation is completed. 



The user SPIE routine passes a parameter 
list identical to that passed to IEAXPALL 
except that the work area is 240 bytes. 
IEAXPDXR processing is identical to that in 
IEAXPALL except that only the divide 
instruction is handled. Any other opera- 
tion code causes control to return to the 
caller with a code of X'FF' in register 15 
and an interruption code of 1 in the PSW. 

If IEAXPDXR is used on a CPU without the 
floating-point feature, an 0C1 ABEND code 
will result when an attempt is made to 
simulate an extended precision divide 
instruction. 



Code Indicator Meaning 
00 unchanged Operation successful; no 
exceptional conditions. 



FF 



FF 



Operation code did not 
specify an extended preci- 
sion operation to be pro- 
cessed by this module; no 
simulation attempted. 

Protection exception 
encountered during simula- 
tion of an MXD instruc- 
tion; operation suppressed. 



SMF ROUTINES 

A discussion of the two major SMF rou- 
tines, which perform the functions 
described above, follows. 

SMF Wait Time Collection Routine (IEAQWAIT) 
Chart AE 

This routine, which resides in the nuc- 
leus, records system wait time. It is 
entered from the first- level interruption 
handlers whenever an external or input/ 
output interruption occurs. 
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If the current TCB represents the system 
wait pseudo task, the system has been in 
wait condition. (Otherwise, control is 
simply returned to the calling interruption 
handler.) The SMF Wait Time Collection 
routine reads the interval timer. The 
timer value is compared with the value in 
the first word of a special save area, SYS- 
WSAVE. The value in SYSWSAVE was placed 
there by the Dispatcher when the system 
entered the wait condition. The comparison 
yields the elapsed system wait time. It is 
added to the value in the second word of 
SYSWSAVE, which gives the accumulated sys- 
tem wait time. 



If the reference was made to a SYSOUT 
data set, the routine checks the TCTOUTLM 
field of the TCT I/O Table to determine if 
an output limit is specified. If an output 
limit is found, it is compared to the total 
of the EXCP count fields for each device 
associated with the data set. If the out- 
put limit is not exceeded, or if none was 
specified, the routine returns to the 
caller. 



Whenever an output limit is exceeded, 
one of the following actions is taken: 



After recording the accumulated system 
wait time, the routine returns control to 
the interruption handler that called it. 

SMF EXCP Counting Routine (IEASMFEX) 
Chart KA 

This routine, which resides in the nuc- 
leus, counts and records the number of 
EXCPs associated with user data sets. The 
count is maintained for all data sets re- 
corded in the TIOT of a problem program. 
It includes both direct EXCPs (SVC 0) and 
indirect EXCPs (those resulting from chan- 
nel end/abnormal end conditions or 
prog rammer- controlled interruptions). The 
routine counts references to the data sets 
by the Open, Close, and EOV routines. 

Upon entry from 10 S the EXCP Counting 
routine performs the following tests; if 
any test fails, control is returned to the 
caller. 

• The TCBTCT field of the TCB is checked 
for the existence of a timing control 
table (TCT). 



• If exits are not allowed, the program 
is abnormally terminated with an error 
code of 722. 

o If exits are allowed, the routine 

creates an IRB/IQE representing the SMF 
Output Limit Expiration routine (IEAT- 
LEXT) . The Stage 2 Exit Effector is 
then entered to schedule the execution 
of IEATLEXT. 



SMF Output Limit Expiration Routine 
(IEATLEXT) Chart KB 

This routine, which is resident in the 
nucleus, provides an interface with a user 
output limit routine (IEFUSO) . 

The routine (IEATLEXT) receives control 
from the EXCP Counting routine when the 
output limit has been exceeded for a SYSOUT 
data set. The routine passes control to 
the user output limit routine. It also 
passes a two-word parameter list containing 
the address of the JMR (Job Management 
Region) and the address of the DCB. 



• The TCTIOTBL field of the TCT is 
checked for the existence of an I/O 
extension of the TCT. 

• The DCBOFLGS field of the DCB is 
checked to assure that the DCB is eith- 
er open or in the process of being 
opened or closed. 

If all tests are successful, the routine 
searches the TCT I/O Table segment of the 
TCT to find the correct EXCP counter 
(TCTDCTR) . There is a counter for each 
combination of DCB and UCB. Counts are 
accumulated on a data set/device basis. 
(See Figure 44.) 



The user routine determines whether or 
not to grant an increase to the output 
limit. It returns control to the SMF Out- 
put Limit Expiration routine with a return 
code of for no increase, or 4 for an 
increase. If the return code is 4, regist- 
er 1 contains the amount of increase to be 
granted. 

If an increase is granted, the SMF Out- 
put Limit Expiration routine adds the value 
of the increase to the output limit speci- 
fied in the TCT I/O Table. If an increase 
is not granted, the routine schedules an 
abnormal termination of the program with an 
error code of 722. 



When the correct EXCP counter has been 
found, the routine adds 1 to the counter. 
Then, if the data set is not SYSOUT, the 
routine returns to the caller. 



Note ; This routine (IEATLEXT) also handles 
time limit expirations. See "Timer Super- 
vision Routines." 
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TCT 



0(0) 



4(4) 



8(8) 



12(C) 



TCTIOTBL 



TCT I/O 
TABLE 



DCB TIOT 

DD Displacements 



UCB Address 



UCB Address 



Output Limit 

Extents Released 
Tracks Released 

UCB Address 



TCTDCTR (EXCP counter) 



TCTOUTLM 



TCTEXRLD 



TCTTKRLD 



TCTUCBP 



TCTSCTR 



TCTDCTR (EXCP counter) 




Address of 
TCT I/O Table 



Pointers to EXCP 
counters 



~ SEE NOTE BELOW 



Number of UCBs 
associated with data 
set (two in this 
example) 



NOTE: The end of the first section of the TCT I/O Table segment is marked by 
an entry of all zeros. The second section follows immediately. 



Figure 44. Example of TCT Pointers Used by EXCP Counting Routine 
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MODULE SYNOPSES 



The following pages provide nonprocess- 
ing information about the supervisor 
modules in the following format: 

Module Name — Common Name : The library 
name of the module. Common name is the 
descriptive name used for the module within 
this publication. 

Chart: The identification of the flowchart 
found following this section. 

CSECT : The CSECT name. This is understood 
to be an entry point and is not included 
under "Entry. " 

Entry : The additional entry point (s) spec- 
ified by entry statements. 

Exit : The module that receives control 
from this module upon completion of 
processing. 

Modules Used : The modules that perform 
processing for this module. Entry to these 
modules is usually by an SVC or BALR 
instruction. 

Table/Work Areas : The control blocks , and 
work areas used by this module. 

Function : A brief description of what this 
module does. 

Modules are grouped by type of supervision 
corresponding to Section 2, "Method of 
Organization." Where one module performs 
several distinct functions, one synopsis is 
given to each of the functions. 



INTERRUPTION SUPERVISION 



^ ►IEAAIHOO — SVC First-Level Interruption 
Handler 



Chart: 



AA 



CSECT : IEAAIHOO 

Entry : IEAASCOO 

Exit : IEAATAOO (SVC SLIH) 

IEA0XE00 (SVC Type 1 Exit) 
IEANTMOO (ABEND) 
IEAODS (Dispatcher) 

Modules Used : IEATRC (Trace) 

Tables/Work Areas : SVCSAV (within 
IEAAIHOO), SVCTABL, CVT, IEATCBP (NEW/OLD 
in Dispatcher), SVC Old PSW. 



Function : Determines the type of SVC re- 
quest, passes control to the appropriate 
Type 1 SVC routine, or passes control to 
the SVC SLIH for Types 2, 3, and 4 requests 
for further processing. 

^IEAAIHOO — SVC Type 1 Exit 

Chart : AA 

CSECT : IEAAIHOO 

Entry : IEAOXE00 from SVC FLIH 

Exit : IEAODS (Dispatcher in IEAAIHOO) 

Tables/Work Areas : SVCSAV (within 
IEAAIHOO), IEATCBP (NEW/OLD in Dispatcher), 
SVC Old PSW. 

Function : Provides return linkage from a 
Type 1 SVC routine. 

^ IEAAIHOO — I/O First-Level Interruption 
Handler 

Chart : AD 

CSECT : IEAAIHOO 

Entry : IEAAIO02 

Exit : DISMISS (in Timer/External FLIH) 

Modules Used : IECINT (I/O Supervisor) 
PSWNDX2 (Trace Routine) 
IEAQWAIT (Wait Time 
Collection) 

Tables/Work Areas : IORGSAV (in IEAAIHOO), 
I/O Old PSW. 

Function : Provides initial processing for 
I/O interruptions. 

^► IEAAIHOO — Timer/External First-Level 
Interruption Handler 

Chart : AD 

CSECT : IEAAIHOO 

Entry : IEAQEXOO 

DISMISS from I/O FLIH 

Exit : IEAODS (Dispatcher) 

Modules Used : IEECVCRX (External SLIH for 
external interruption) 
IEA0TI00 (Timer SLIH for 
timer interruption) 
IEAQWAIT (Wait Time 
Collection) 
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Tables/Work Areas ; IORGSAV (in IEAAIHOO) , 
PDSAV (in IEAAIHOO), External Old PSW, 
IEATCBP (NEW/OLD in Dispatcher). 

Function ; Provides initial processing for 
timer and external interruptions. 

^IEAAIHOO — Program Check First-Level 
Interruption Handler 

Chart ; AE 

CSECT ; IEAAIHOO 

Entry ; IEAAPKOO 

Exit ; IEA0PL00 (ABTERM) 

Modules Used ; IHLMCIH (Monitor Call Inter- 
ruption Handler) 

Tables/Work Areas ; Program Old PSW, 
IEATCBP (NEW/OLD in Dispatcher), PIE, PICA. 

Function ; Processes program check 
interruptions . 



Modules Used ; IEAAMSOO (GETMAIN) 
IEAOABOO (ABTERM) 
IEAOFNOO (FINCH in IEAATCOO) 
IEAASPRG (Subsystem purge) 

Tables/Work Areas ; SVC Old PSW, CVT, 
XSNTCC. 

Function ; Determines the type of SVC re- 
guest and passes control to the appropriate 
type 2, 3, or 4 routine. 



^IEAAIHOO — Dispatcher 
Chart ; AF 
CSECT: IEAAIHOO 



Entry : IEAODS 

XTG from Stage 3 Exit Effector 

Exit ; IEAEXTEF (Stage 3 Exit Effector) 
IEAATAOO (DXA in EXIT) 
Highest-priority ready task via LPSW 
instruction 

Modules Used : IEA0TI02 (Timer 
Enqueue/Dequeue ) 
IEATRC (Trace) 

IEAATAOO (SVRB create in SVC 
SLIH) 
IEAOFNOO (FINCH) 

Tables/Work Areas : CVT, PIB, XSNTCC (in 
IEAATCOO) . 

Function; Pass control to the highest 
priority ready task in the system. 

^ ►IEAATAOO — SVC Second-Level Interruption 
Handler 

Chart ; AB 

CSECT : IEAATAOO 

Entry ; SVE from SVC FLIH 

ABENDSUC return from GETMAIN 

Exit : IEAAXT (EXIT in IEAATAOO) 
IEAODS (Dispatcher) 
IEELOGWR (Log routine) 



!► IEAATAOO — SVC EXIT 

Chart : AC 

CSECT : IEAATAOO 

Entry ; IEAAXT 

IGC003 (SVC 3) 
DXA from FINCH 

Exit : IEAODS (Dispatcher) 
IEANTMOO (ABEND) 

Modules Used : AIOS (I/O Supervisor) 
IEAADLOO (DELETE) 
IEAAMSOO (FREEMAIN) 
IEAOEFOO (Stage 2 Exit 
Effector) 
IEAAPTOO (POST) 
IEA0TI02 (Timer Dequeue) 

Tables/Work Areas : SVCSAV, SVC Old PSW, 
PIE, IEATCBP (NEW/OLD in Dispatcher), CVT. 

Function : Provides return processing from 
Types 2, 3, and 4 SVC routines. 



^IEAATAOO — Validity Check 

CSECT : IEAATAOO 

Entry : IEAOVLOO 

Exit : Return to caller 

Tables/Work Areas : IEATCBP (NEW/OLD in 
Dispatcher) and protection key 

Function : Provides address validity 
checking. 

^ ►IEAATAOO — Task Switch Determination 

CSECT : IEAATAOO 

Entry : TASKSWIT 

Exit : Return to caller 

Tables/Work Areas : IEAHEAD, IEATCBP (NEW/ 
OLD in Dispatcher) . 

Function : Searches the TCB queue for the 
highest priority ready task and sets 
IEATCBP (NEW in Dispatcher) to that 
address. 
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TASK SUPERVISION 

^ ■IEAQATOO — ATTACH with Subtaskinq 

Chart : BA 

CSECT : IGC042 

Exit : IEAODS (Dispatcher) 
IEAATAOO (EXIT) 
IEANTMOO (ABEND) 



Modules Used: 



IEA0PL00 (ABTERM) 
IEAAMSOO (GETMAIN) 



Tables/Work Areas ; 
Dispatcher) 



IEATCBP (NEW/OLD in 



Function : Creates a TCB and a dummy PRB 
for the specified subtask. The resume PSW 
in the dummy PRB points to an SVC 6 (LINK) 
instruction which will create the request 
block for the requested module and place it 
on the RB queue of the subtask TCB. 



^ IEAGED02 — DETACH 

Chart : BB 

CSECT : IGC062 

Exit : IEAATAOO (EXIT) 
IEANTMOO (ABEND) 

Modules Used : IEA0VL00 (Validity Check in 
IEAATAOO) 
IEA0AB00 (ABTERM) 
IEAAMSOO (GETMAIN/FREEMAIN) 
IJEAAWTOO (WAIT) 
IEAAPTOO (POST) 

Tables/Work Areas : CVT 

Function : Removes the TCB and RB for an 
attached subtask. 



^► IEAAXROO — EXTRACT without Subtaskinq 

Chart : BD 

CSECT : IGC040 

Exit : IEAATAOO (EXIT) 

Tables/Work Areas : TIOT, CVT. 

Function : Returns the address of the Task 
I/O Table to the caller. 

^► IEABXROO — EXTRACT with Subtaskinq 

Chart : BE 

CSECT : IGC040 

Exit : IEAATAOO (EXIT) 
IEANTMOO (ABEND) 

Tables/Work Areas : IEATCBP (NEW in 
Dispatcher) 

Function : Returns requested data from 
fields in the TCB of the caller, or from 
the TCB of a caller's subtask. 

^ ►IEAAWTOO — WAIT 

Chart : BF 

CSECT : IGC001 

Exit : IEAOXEOO (SVC Type 1 Exit) 

Modules Used : IEA0VL00 (Validity Check) 
IEA0AB00 (ABTERM) 

Tables/Work Areas : IEATCBP (NEW/OLD in 
Dispatcher) 

Function : Enables the caller for I/O and 
external interruptions and sets the wait 
bit on in the specified ECB. 



^ ►IEAQCHOO — CHAP 

Chart : BC 

CSECT : IGC044 

Exit : IEANTMOO (ABEND) 
return to caller 



Modules Used : IEAATAOO (TASKSWIT) 

Tables/Work Areas : CVT. 

Function : Changes the dispatching priority 
of the caller or a subtask of the caller, 
and reorders the queue of TCBs accordingly. 



^ IEAAPTOO — POST 

Chart : BG 

CSECT : IGC002 

Exit : IEAOXEOO (SVC Type 1 Exit) 

Modules Used : IEA0AB00 (ABTERM) 

Tables/Work Areas : CVT, IEATCBP (NEW/OLD 
in Dispatcher) 

Function : Sets on the completion bit in 
the specified ECB, decrements the wait 
count, and, if the wait count is 0, sets 
off the wait bit. 
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^ ►IEAGENQl — ENQ 



Chart ; BH 

CSECT ; IGC048 

Entry ; IGC056 

Exit ; IEAODS (Dispatcher) 
IEAATAOO (EXIT) 
IEANTMOO (ABEND) 



Modules Used: 



IEA0VL00 (Validity Check) 
IEAAMSOO (GETMAIN) 



Function; Provides the caller with exclu- 
sive or shared access to a specified 
device. 



^ IEAGENQ2 — ENQ with Shared DASD 

See IEAGENQ1 (ENQ). 

Function ; In addition to the ENQ f unc- 
tions , this module processes RESERVE macro 
instruction requests. 



^IEAGENQl — DEQ 

Chart ; BJ 

CSECT ; IGC048 

Exit : IEAATAOO (EXIT) 
IEANTMOO (ABEND) 

Modules Used : IEAAMSOO (FREEMAIN) 
IEAATAOO (TASKWIT) 

Function : Releases resources from accessi- 
bility to a program. 

^► IEAGENQ2 — DEQ with Shared DASD 

See IEAGENQ1 (DEQ). 

Function : In addition to the DEQ func- 
tions, this module initiates I/O activity 
when the reserve count is zero so that IOS 
will release the device. 

^ IEAAPXOO — SPIE 

Chart : BK 

CSECT : IGC014 

Exit : IEAATAOO (EXIT) 

Tables/Work Areas : PIE, PICA, CVT. 

Function : Creates pointers from the TCB 
through the PIE and PICA to the specified 
user error handling routine. 



^IEAASTOO — STAE 

Chart : BL 

CSECT : IGC00060 

Exit : Return to caller. 

Modules Used : IEAAMSOO (GETMAIN/FREEMAIN) 

Tables/Work Areas : SCB 

Function : Creates , cancels, or overlays a 
STAE control block 



^► IEAQEFOO — Stage 1 Exit Effector 

Chart : BM 

CSECT : IGC043 

Exit : IEAATAOO (EXIT) 

Modules Used : IEAAMSOO (GETMAIN) 

Function : In response to an ETXR operand 
in a macro instruction, creates and queues 
an IRB for a user exit routine. 

^ IEAAIHOO -- Stage 2 Exit Effector 



Chart : 
CSECT : 
Entry : 
Exit : 



BN 

IEAAIHOO 
IEA0EF00 
Return to caller 



Tables/Work Areas : LEQA (queue of RQEs in 
IEAAIHOO), LEQC (queue of IQEs in IEAAIHOO) 

Function : Places IQEs and RQEs on the 
appropriate queues and sets a switch in the 
Dispatcher to enter the Stage 3 Exit 
Effector. 



^IEAAIHOO — Stage 3 Exit Effector 
Chart: BO 



CSECT: 



IEAEXTEF 



Exit ; IEAODS (Dispatcher) 

Modules Used ; SXA (Error Transient Area 
Scheduler in IEAAIHOO) 
TASKSWIT (Task Switch Deter- 
mination in IEAATAOO) 

Function : Moves IQEs and RQEs from their 
respective queues to queues originating in 
the IRBs for the associated user exit 
routine. 



150 



TASK TERMINATION 



Exit: IEANTM04 (ABEND 4) 



^► IEANTMOO — ABEND 
Chart : CA 

IGC0001C 



CSECT: 



Exit: 



IEANTMOB (ABEND 11) 

IEANTMOC (ABEND 12) 

IEANTMOG (ABEND G) 

IEFSD515 (Master Scheduler GO) 

IEFSD599 (Master Scheduler SMALLGO) 

IEAAWT00 (WAIT) 



Modules Used: 



IEAQCHOO (CHAP) 

IEAAMSOO (GETMAIN/FREEMAIN) 

IEA0AB00 (ABTERM) 

IEA0ST00 (TTIMER) 

IGC0002x (Close) 



Tables/Work Areas: 



CVT 



Function : Determines the type of termina- 
tion; processes normal termination or 
routes abnormal termination. 



^ ►IEANTMOl — ABEND 1 

Chart : CC 

CSECT : IGC0101C 

Exit : IEANTMOB (ABEND 11) 

Modules Used : IEA0ST00 (TTIMER) 

IEAQOCR (Graphics Purge) 
IEAAMSOO (FREEMAIN) 

Tables/Work Areas : CVT, TCB 

Function : Schedule graphics hook; purge 
request queues. 

^ IEANTM02 — ABEND 2 

Chart : CD 

CSECT : IGC0201C 

Exit : IEANTM03 (ABEND 3) 
IEANTM09 (ABEND 9) 
IEADTM22 (DAR 1) 

Tables/Work Areas : CVT, IEATCBP (NEW/OLD 
in Dispatcher) 

Function : Performs I/O purge function. 

^ IEANTM03 — ABEND 3 
Chart : CD 
CSECT: IGC0301C 



Tables/Work Areas : CVT, IEATCBP (NEW/OLD 
in Dispatcher) 

Function : Checks validity of request 
blocks. 



^ IEANTM04 — ABEND 4 

Chart : CE 

CSECT : IGC0401C 

Exit : IEANTM05 (ABEND 5) 

IEANTM07 (ABEND 7) 

IEANTM08 (ABEND 8) 

IEANTMOA (ABEND 10) 

IEANTMOC (ABEND 12) 

IEANTMOD (ABEND 13) 

IEANTMOF (ABEND 15) 

Modules Used : IEAAMSOO (GETMAIN/FREEMAIN) 

Tables/Work Areas : CVT 

Function : Determines if a dump is required 
and ensures that sufficient main storage is 
available for subsequent functions. 

^ >IEAMTM05 — ABEND 5 (without Subtaskinq) 
|^ IEANTM05 — ABEND 5 (with Subtaskinq) 

Chart : CF 

CSECT : IGC0501C 

Exit : IEANTM09 (ABEND 9) 
IEANTM06 (ABEND 6) 
IEAODS (Dispatcher) 



Modules Used : 



IEAAMSOO (GETMAIN) 

IGC0001I (OPEN) 

IEA0AB00 (ABTERM) 

IEAGENQ1 (ENQ) 



Tables/Work Areas; 



IEATCBP (NEW/OLD in 



Dispatcher), CVT, TIOT, DEB, DCB, UCB. 

Function : Opens the dump data set if poss- 
ible. For MFT with subtasking, subtasks 
enqueued on the dump data set are dequeued 
and the terminating task is enqueued. 



^► IEANTM06 — ABEND 6 
Chart : CC 

IGC0601C 



CSECT: 



Exit: 



IEANTM07 (ABEND 7) 
IEANTM09 (ABEND 9) 
IEANTMOC (ABEND 12) 
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IEANTMOD (ABEND 13) 
IEANTMOF (ABEND 15) 

Modules Used ; IEAAMSOO (GETMAIN/FREEMAIN) 
IEAAADOO (SNAP) 

Tables/Work Areas : CVT , TCB 

Function : Prints dump messages and invokes 
ABDUMP. 



CSECT : IGC0A01C 

Exit ; IEANTM04 (ABEND 4) 

Modules Used ; IEAAMSOO (GETMAIN/FREEMAIN) 

Tables/Work Areas : CVT 

Function : Steals main storage for essen- 
tial ABEND functions when there is insuffi- 
cient main storage. 



^IEANTM07 — ABEND 7 

Chart : CH 

CSECT : IGC0701C 

Exit : IEFSD515 (Master Scheduler GO) 

IEFSD599 (Master Scheduler SMALLGO) 

Modules Used : IEA0AB00 (ABTERM) 
IEAQCHOO (CHAP) 
IGC0002X (CLOSE) 

Tables/Work Areas : CVT, IEEMSER (Master 
Scheduler Resident Data Area) f IEATCBP 
(NEW/OLD in Dispatcher), TCB. 

Function : Closes all data sets, dequeues 
IQEs . 

^ >IEANTM08 — ABEND 8 
Chart : CH 

IGC0801C 



CSECT: 



Exit: 



IEANTM07 (ABEND 7) 
IEANTMOD (ABEND 13) 
IEANTMOF (ABEND 15) 



Function : Formats indicative dump. 

^IEANTM09 — ABEND 9 

Chart : CI 

CSECT : IGC0901C 

Exit : IEANTM04 (ABEND 4) 

Modules Used : IEAAMSOO (GETMAIN/FREEMAIN) 
IEAGENQ1 (DEQ) 
IEECVWTO (WTO) 

Tables/Work Areas : IEATCBP (NEW/OLD in 
Dispatcher), CVT, GQE. 

Function: Processes recursions. 



^IEANTMOA — ABEND 10 
Chart : C J 



^ ►IEACTMOB — ABEND 11 (with MCS) 
See IEANTMOB. 

^ IEANTMOB — ABEND 11 (without MCS) 

Chart : CK 

CSECT : IGC0B01C 

Exit : IEANTM00 (ABEND 0) 

IEANTM01 (ABEND 1) 

IEANTMOC (ABEND 12) 

IEASTM13 (ASIR 3) 

Modules Used : IEAAMSOO (GETMAIN/FREEMAIN) 

Tables/Work Areas : IEECUCB (pointer to 
UCM) , IEATCBP (NEW/OLD in Dispatcher) 

Function : Purge WTOR queue and end any 
unended Multiple- line WTORs. 

^ IEANTMOC — ABEND 12 

Chart : CK 

CSECT : IGC0C01C 

Exit : IEANTMOD (ABEND 13) 

Modules Used : IEAAMSOO (GETMAIN/FREEMAIN) 

Tables/Work Areas : IEATCBP (NEW/OLD in 
Dispatcher) 

Function : Frees partially loaded programs 
and FRBs for the terminating task. 

^IEANTMOD — ABEND 13 (Subtaskinq Only) 

Chart ; CK 

CSECT : IGC0D01C 

Exit : IEANTMOF (ABEND 15) 

Modules Used : IEAGENQ1 (DEQ) 

Tables/Work Areas : IEATCBP (NEW/OLD in 
Dispatcher) . 
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Function ; Performs an ENQ purge. 



Chart : CO 



^► IEANTMOE — ABEND 14 (Suhtaskinq Only) 

Chart ; CL 

CSECT ; IGC0E01C 

Exit ; IEANTM07 (ABEND 7) 
IEAATAOO (EXIT) 

Modules Used ; IEAAWTOO (WAIT) 
IGC0002X (CLOSE) 
IEAAMSOO (GETMAIN/FREEMAIN) 

Tables/Work Areas ; IEATCBP (NEW/OLD in 
Dispatcher) , LEQC (IQE queue in IEAAIH00) , 
IECIXAVL (pointer to TCB table of 
addresses) , CVT. 

Function ; Closes data sets and purges RB 
queue. 

^ ►IEANTMOF — ABEND 15 (Subtaskinq only) 

Chart ; CM 

CSECT ; IGC0F01C 

Exit ; IEANTMOE (ABEND 14) 

Modules Used ; IEAAMS (GETMAIN/FREEMAIN) 

Tables/Work Areas ; TCB 

Function ; Purges IQEs and queues associated 
with subtasks of the terminating task. 

^IEANTMOG — ABEND G 
Chart; CB 



CSECT ; IGC0H01C 

Exit ; IEANTM04 (ABEND 4) 

Modules Used ; IEAAMSOO (GETMAIN/FREEMAIN) 
IEEMFWTO (WTO) 

Tables/Work Areas ; TCB, CVT, DEB, TIOT 

Function ; Issues WTO messages identifying 
valid recursions. 



^IEANTMOJ — ABEND J (with Subtaskinq) 

Chart ; CP 

CSECT ; IGC0J01C 

Exit ; IEANTM04 (ABEND 4) 

Tables/Work Areas ; CVT, IEATCBP, TCB 

Function ; Checks validity of subtasking 
control blocks. 

I^ IEANTMOM — ABEND M 
Chart ; CN 
CSECT ; IGC0M01C 
Exit; IEANTMOG (ABEND G) 



Modules Used; 



IEAAMSOO (GETMAIN/FREEMAIN) 
IEECVWTO (WTO) 



CSECT; IGC0G01C 



Tables /Work Areas ; CVT, Message Informa- 
tion List 

Function ; When invoked by ABEND G, issues 
WTP messages for Type-1 SVC routines. 



Exit ; IEANTM01 
IEANTM02 
IEANTMOM 
IEAAATOO 
IEADTM22 
IEADTM23 
IEASTM11 

Modules Used: 



(ABEND 1) 
(ABEND 2) 
(ABEND M) 
(EXIT) 
(DAR 1) 
(DAR 2) 
(ASIR 1) 

IEAAMSOO (GETMAIN/FREEMAIN) 
IEA0AB00 (ABTERM) 
IEAAWTOO (WAIT) 



^IEASTMll — ASIR 1 
Chart ; CQ 

IGC0111C 



CSECT; 



Exit: 



Tables/Work Areas : TCB, CVT, SCB, PIE, 
PICA 



IEASTM12 (ASIR 2) 

IEASTM13 (ASIR 3) 

IEANTM01 (ABEND 1) 

IEAATAOO (EXIT) 



Modules Used : IEAAMSOO (GETMAIN/FREEMAIN) 
IEAASYOO (SYNCH) 
IGC0001F (Purge) 



Function : Process abnormal termination and Tables/Work Areas : CVT, SCB 



ABEND recursions. 



^► IEANTMOH — ABEND H 



Function ; Purges I/O, schedules user exit 
routine, and routes control for retry if 
requested. 
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^ >IEASTM12 — ASIR 2 

Chart ; CR 

CSECT : IGC0 211C 

Exit ; IEASTM14 (ASIR 4) 

IEANTMOB (ABEND 11) 
IEAATAOO (EXIT) 

Modules Used ; IGC0002x (Close) 

Tables/Work Areas ; CVT, IOB, SCB. 

Function ; Dequeues IOBs and closes DCBs 
with organizations other than ISAM or TAM 
for request blocks that will be purged. 

^IEASTM13 — ASIR 3 

Chart ; CS 

CSECT ; IGC0311C 

Exit ; IEAATAOO (EXIT) 

User's retry routine 

Modules Used ; IEAAMSOO ( GETMAIN/FREEMAIN) 

Tables/Work Areas ; CVT, SCB. 

Function ; Purges request block queue and 
schedules retry routine. 



^IEASTM14 — ASIR U 

Chart ; CT 

CSECT ; IGC0411C 

Exit ; IEASTM13 (ASIR 3) 

IEANTMOB (ABEND 11) 
IEAATAOO (EXIT) 

Modules Used ; IGC0002x (Close) 

Tables/Work Areas ; CVT, SCB, IOB. 

Function ; Dequeue IOBs and close DCBs with 
ISAM or TAM organizations associated with 
request blocks that are going to be purged. 

^IEAIABOQ — ABTERM (with Trace Table) 
^IEAGABOO — ABTERM (without Trace Table) 



Tables/Work Areas ; CVT, TCB 

Function ; Schedules the abnormal termina- 
tion of a specified task. 

^ IEANAMOO — ABTERM (with Subtaskinq) 

Chart ; CY 

CSECT ; IEA0AB00 

Exit ; Return to caller 

Modules Used ; IEAATAOO (IEAXERR — Tran- 
sient Area Loading Task refresh routine. 

Function ; Schedules the abnormal termina- 
tion of a specified task. 

^> IEADTM22 — PAR 1 

Chart ; CU 

CSECT ; IGC0221C 

Exit ; IEADTM23 (DAR 2) 

Tables/Work Areas ; CVT 

Function ; Sets all tasks except the cur- 
rent task nondispatchable f and issues an 
SVC 51 (SVC Dump). 

^ IEADTM23 — DAR 2 

Chart ; CV 

CSECT ; IGCG0321C 

Exit ; IEAODS (Dispatcher) 
IEAGABOO (ABTERM) 

Modules Used ; IEECVWTO (WTO) 

Tables/Work Areas ; SVT 

Function ; Attempts to reinstate system 
takks not in "must complete" status. 



Chart: 



CSECT; 



CY 
IEA0AB00 



Return to caller 

IEAAIHOO (DISMISS in I/O FLIH) 



Exit 

Modules Used 

Loading Task refresh routine) 



IEAATCOO (Transient Area 



^IEADTM24 — DAR 3 

Chart ; CW 

CSECT ; IGC0421C 

Exit ; IEANTM03 (ABEND 3) 
IEADTM25 (DAR 4) 

Modules Used ; IEEMFWTO (WTO) 

IEAASPRG (Subsystem purge) 
IEEVWTOR (WTOR) 

Tables/Work Areas ; CVT, QCBs, QEL, TCB. 
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Function : Attempts to reinstate system 
tasks in "must complete" status and problem 
program tasks. Routes control for con- 
tinuation of abnormal termination. 



^IEADTM25 — PAR 4 

Chart ; CX 

CSECT : IGC0521C 

Exit ; IEA0DS (Dispatcher) 

Modules Used : IEAASPRG (Subsystem Purge) 

Tables/Work Areas : CVT, TCB, RB 

Function : Sets nonreinstatable tasks per- 
manently nondispatchable. 

^ ►IEAMADOO — ABDUMP 1 

Chart : DC 

CSECT : IGC0L05A 

Exit : IEAAADOD (ABDUMP 2) 

Modules Used : IEAAMSOO (GETMAIN/FREEMAIN) 
IEAGENQ1 (ENQ) 

Tables/Work Areas : CVT, DCB f TCB. 

Function : Validity checks DCB and TCB 
addresses and obtains work area. 



[ ►iEAAADOl — ABDUMP 4 
Chart : DE 

IGC0105A 



^IEAAADOD — ABDUMP 2 

Chart : DD 

CSECT : IGC0D05A 

Exit : IEAAADOA (ABDUMP 3) 
IEAAAD02 (ABDUMP 5) 
IEAAAD03 (ABDUMP 6) 

Tables/Work Areas : TIOT 

Function : Dumps heading, completion code, 
interruption code, and PSW. 



^IEAAADOA — ABDUMP 3 
Chart : DD 
CSECT : IGC0A05A 
Exit : IEAAAD01 (ABDUMP 4) 
Function : Dumps TCB, active RBs, and LRBs. 



CSECT: 



Exit: 



IEAAAD02 (ABDUMP 5) 
IEAAAD03 (ABDUMP 6) 



Function : Dumps Job Pack Area Queue, GQEs, 
FQEs, and problem program boundaries. 



^IEAAAD02 — ABDUMP 5 
Chart : DF 
CSECT : IGC0205A 
Exit : IEAAAD03 (ABDUMP 6) 
Function : Dumps save areas. 



^IEAAAD03 — ABDUMP 6 

Chart : DF 

CSECT : IGC0305A 

Exit : IEAAADOB (ABDUMP 7) 
IEAAAD04 (ABDUMP 8) 
IEAAAD0K (ABDUMP 13) 

Tables/Work Areas : TIOT, DEB, DCB, UCB, 
TCB. 

Function : Dumps data set information per- 
tinent to the task. 



^ IEAAADOB — ABDUMP 7 
Chart : DG 
CSECT : IGC0B05A 
Exit : IEAAADOU (ABDUMP 8) 
Function : Dumps the trace table. 

fe lEAAADOl — ABDUMP 8 
Chart : DG 
CSECT : IGC0405A 
Exit : IEAAAD05 (ABDUMP 9) 
Function : Dumps registers. 

^IEAAAD05 — ABDUMP 9 
Chart: DH 
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CSECT : IGC0505A 

Exit : IEAAADOE (ABDUMP 10) 
IEAAADOC (ABDUMP 11) 



Tables/Work Areas: 



CVT 



Function ; Dumps the nucleus of main 
storage. 



CSECT ; IGC0H05A 

Exit : IEAAADOI (TCAM ABDUMP 3) 

Tables/Work Areas ; TCAM AVT, TCAM TNT f 
TCAM TRM 

Function : Formats and prints the terminal 
names as they appear on the TNT and their 
associated TRM entries. 



^ IEAAADOE — ABDUMP 10 
Chart : DH 
CSECT : IGC0E05A 
Exit : IEAAADOC (ABDUMP 11) 
Tables /Work Areas : CVT 
Function : Dumps problem program storage. 

^IEAAADOC — ABDUMP 11 

Chart : DH 

CSECT : IGC0C05A 

Exit : IEAAADOF (ABDUMP 12) 

Function : Dumps snapshot and resident 
reenterable modules. 

I ^IEAAADOF — ABDUMP 12 

Chart : DI 

CSECT : IGC0F05A 

Exit : Return to caller 

Tables/Work Areas : CVT 

Function : Prints end of dump message and 
frees work area. 

^ IEAAADOG — TCAM ABDUMP 1 

Chart : DL 

CSECT : IGC0G05A 

Exit : IEAAADOH (TCAM ABDUMP 2) 

Tables/Work Areas : TCAM AVT, TCAM TNT 

Function : Formats and prints the AVT in 
the basic section of the TNT. 

^ ►IEAAADOH — TCAM ABDUMP 2 
Chart: DL 



^ IEAAADOI — TCAM ABDUMP 3 

Chart : DM 

CSECT : IGC0I05A 

Exit : IEAAADOJ (TCAM ABDUMP 4) 

Tables/Work Areas : TCAM AVT, TCAM TNT f 
TCAM TRM, TCAM QCB 

Function : Formats and prints the TCAM 
Destination QCBs associated with the TRM 
entries. 

^ ►IEAAADOJ — TCAM ABDUMP 4 

Chart : DM 

CSECT : IGC0J05A 

Exit: IEAAADOB (ABDUMP 7) 
IEAAAD04 (ABDUMP 8) 
IEAAADOK (ABDUMP 13) 

Tables/Work Areas : TCAM DCB, TCAM LCB, CVT 

Function : Formats and prints open TCAM 
DCBs and the LCBs associated with Line 
Group DCBs. 

^IEAAADOK — ABDUMP 13 

Chart : DJ 

CSECT : IEAAADOK 

Entry : IGC0K05A 

Exit ; IEAAAD04 (ABDUMP 8) 
IEAAADOM (ABDUMP 14) 

Tables/Work Areas : CVT, TCB, CMT, HCT 

Function : Formats and prints the GTF trace 
records . 

^IEAAADOM — ABDUMP 14 
Chart : DK 
CSECT: IEAAADOM 
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Entry : IGC0M05A 

Exit : IEAAADOK (ABDUMP 13) 

Tables/Work Areas : C VT „ HCT 

Function : Prints GTF control and error 
records. 

^ IEAAADOY — SVC DUMP 1 

Chart : DA 

CSECT : IGC0005A 

Exit : IEAATAOO (EXIT) 

IEAAADOZ (SVC DUMP 2) 
IEAMADOO (ABDUMP 1) 

Modules Used : IEAA0AB00 (ABTERM) 
EXCP 

IEAAWTOO (WAIT) 
IEAAMS (GETMAIN) 
IEA0RT00 (TIME) 

Tables/Work Areas : CVT, SVRB, IOB, DCB, 
DEB, ECB 

Function: Sets up necessary control blocks 
and writes a dump of main storage to a 
specified data set on a direct access 
device. 



frfr> IEAAADOZ — SVC DUMP 2 



Chart : DB 

CSECT : IGC0Z05A 

Exit : IEAATAOO (EXIT) 

Modules Used : EXCP 

IEAAWTOO (WAIT) 
IEAAMS (FREEMAIN) 
IEA0RT00 (TIME) 

Tables/Work Areas : CVT, SVRB, IOB f DCB, 
DEB, ECB 

Function : Writes a dump of main storage to 
a specified data set on tape. 



^► IEAASPRG — Subsystem Purge 

CSECT : IEAASPRG 

Entry : IEAASPRG 

Exit : Return to Caller 

Function: Allows subsystems to execute 
recovery procedures before being set per- 
manently nondispatchable. 
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CONTENTS SUPERVISION 
^IEAAATOO — ATTACH without Subtaskinq 
Chart ; EA 

IGC04 2 



Exit : Return to caller 
IEANTMOO (ABEND) 



Modules Used: 



IEAAMSO (GETMAIN/FREEMAIN) 
BLDL, Program Fetch, 
IEAATC (LOAD) 



CSECT : 
Entry : 

Exit: 



IEA0AT01 reentry from Dispatcher 
IEA0AT02 return from called routine 

IEAATAOO (EXIT) 

IEAODS (Dispatcher in IEAAINOO) 



Tables/Work Areas : CVT r IEATCBP (NEW/OLD 
in Dispatcher) , XSNTCC (in IEAATAOO). 

Function : Provides the preparation neces- 
sary for Program Fetch to bring a requested 
module into main storage. 



Modules Used: 



IEAAMSOO (GETMAIN/FREEMAIN) 
IEA0FN00 (FINCH) 



Tables/Work Areas: 



CVT 



Function : Creates a requested module, 
places it on the RB queue, and ensures that 
the requested module is in main storage. 

^ ►IEAATC 00 — LINK, LOAD, XCTL 

Chart : EB 

CSECT : IGC006 (LINK) 

Entry : IGC007 (XCTL) 
IGC008 (LOAD) 

Exit : IEAATAOO (EXIT) 
IEANTMOO (ABEND) 
IEAODS (Dispatcher) 



Modules Used: 



IEAAMSO (GETMAIN/FREEMAIN) 
TASKSWIT (Task switch deter- 
mination in IEAATAOO) 
XFINCH (in IEAATC00) 
IEAADL00 (DELETE) 



Tables/Work Areas : CVT, Loaded Program 
List, Job Pack Area Queue, Resident Reent- 
erable Module Area, Resident Access Method 
List. 

Function : LOAD ensures that a copy of a 
module is available in main storage and 
returns its entry point to the caller. 
LINK ensures that a copy of the module is 
available in main storage, places a request 
block for it on the top of the RB queue, 
and provides for return linkage to the 
caller. XCTL ensures that a copy of the 
module is available in main storage, places 
a request block for it on the RB queue, and 
removes the caller and its RB from main 
storage. 

^ IEAATCOO — FINCH 

Chart : EC, ED 

CSECT: IGC006 



Entry : 



IEA0FN00 
XFINCH 



^ ►IEAATC 00 — Transient Area Loading Task 

Chart : ED 

CSECT : IGC006 

Entry : IEAFNCH 

Exit : Return to caller 

Modules Used : Program Fetch 

IEA0AB00 (ABTERM) 
IGFDDRSR (Dynamic Device 
Reconfiguration) 

Function: This section of IEAATC 00 
executes under its own TCB to bring the 
requested module in the SVC transient area. 

^IEAAIDOO — IDENTIFY 

Chart : EE 

CSECT : IGC041 

Exit : IEAATAOO (EXIT) 

Modules Used : IEAAMSOO (GETMAIN) 

Function : Creates a minor request block 
for the specified module and places it on 
the Loaded Program List and on the minor RB 
queue of the identified routine. 

^IEAADLOO — DELETE 

Chart : EF 

CSECT : IGC009 

Exit : Return to caller 

Modules Used : IEAAMSOO (FREEMAIN) 

Tables/Work Areas : Resident Access Method 
List, Loaded Program List, Job Pack Area 
Queue. 

Function : Finds the RB for the nonresident 
module and decrements the use count. If 
the use count becomes zero, the RB and the 
module are removed from main storage. 
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MAIN STORAGE SUPERVISION 



Chart : GB 



► IEAAMS — GETMAIN/FREEMAIN 

Chart : FA 

CSECT ; IGC010 

Entry ; IGCOOU (GETMAIN) 
IGC005 (FREEMAIN) 

Exit : IEAAIHOO (IEA0XE00 — Type 1 SVC 
Exit) 

Tables/Work Areas : Boundary Box, FQE, GQE. 

Function : Allocates and frees main 
storage. 



COMMUNICATIONS TASK 



^- IEECVCTI — Communications Task 
Initialization 



Chart: GA 



CSECT: IEECVCTI 



CSECT : IEEBC1PE 

Exit : Return to I/O FLIH 

Modules Used : IEAAPTOO (POST ) 

Tables/Work Areas : CVT, UCM. 

Function : Posts the external ECB for an 
external interruption. 



^► IEEVWTOR — Communications Task WTOR 
Service 

Chart : GE 

CSECT : IGC0103E 

Exit : IEAATAOO (EXIT) 

IEANTMOO (ABEND 0) 
IEECVWTO (WTOR Service) 

Modules Used : IEAAMS 00 (GETMAIN) 
IEAGENQ1 (ENQ/DEQ) 
IEAAWT00 (WAIT) 

Function : Provides buffer management and 
message identification. 



Exit : IEFSD569 (Master Scheduler 
Initialization) 

Modules Used : IEAATC00 (LOAD) 

IEAAMS00 (GETMAIN/FREEMAIN) 

IEEVRFRX (Refer) 

IEECVWTO ( Write- to-Operator) 

IEAAPTOO (POST) 

Tables/Work Areas : UCM, Event Indication 
List (EIL). 

Function : Initializes the Unit Control 
Module (UCM) . 

^ IEECVCRA — Communications Task I/O 
Attention Handler 

Chart : GB 

CSECT : IEEBA1 

Exit : Return to I OS 

Modules Used : IEAAPTOO (POST) 

Tables/Work Areas : CVT, UCM. 

Function : Posts the attention ECB for an 
I/O attention. 



►IEECVCRX — Communications Task External 
Interruption Handler 



^► IEECVCTW — Communications Task Wait 
(non-MCS) 

Chart : GF 

CSECT : IEECIR45 

Exit : IEECVCTR (Router) 

Tables/Work Areas : UCM, EIL, CVT, 
IEEBASEB. 

Function : Issues an SVC 72 instruction 
when one of the ECBs waited on by IEECVCTW 
is posted. 



► IEECVCTR — Communications Task Router 
(non-MCS) 



Chart : 



GG 



CSECT : IGC0007B 

Exit : IEECVCTX (Console Switch) 

IEECVPMx (Device processor indicated 

by "x") 

Return to IEECVCTW 

Function : Determines from the ECB posted 
the type of processing necessary and passes 
control to the appropriate routine. 
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^ ►IEECVCTX — Communications Task Console 
Switch (non-MCS) 

Chart ; GH 

CSECT : IGCXL07B 

Exit : Return to IEECVCTW 

IEECVPMx (Device processor indicated 
by "x") 

Function: Assigns functions of the primary 
console to the alternate console. 



Modules Used : IEAAMSOO (GETMAIN/FREEMAIN) 

Function : Performs Open/Close function for 
the 1052 console. 



^IEECVGCI — Graphic Console Initailization 

CSECT : IEECVGCI 

Exit : IEECVCT1 (Console Initialization) 

Tables/Work Areas : UCM, DCM 

Modules Used : IEECVWTO (WTO) 
EXCP 
OPEN 
LOCATE 
BLDL 

Function : Initializes display operator 
consoles. 

^ IEECVPMX — 1052 Processor Load 1 (non-MCS) 

Chart : GO 

CSECT : IGC0107B 

Entry : IEECVPM 

Exit : IEECVCTX (Console Switch) 
IEECVCTR (Router) 
IEECVOCX (1052 Open/Close) 
IEECVPM1 (Non-MCS Load 2) 

Modules Used : IEAAMSOO (GETMAIN/FREEMAIN) 
IEAAPT00 (POST) 
IEAAWT00 (WAIT) 
IEE0303D (Command Processor) 

Function: Performs read and write opera- 
tions for a 1052 console. 

^IEECVOCX — 1052 Open/Close 

Chart : GQ 

CSECT : IGC0I07B 

Entry : IEECVOC 

Exit : IEECVPMX (1052 Processor non-MCS) 

IEECVCTX (console Switch non-MCS) 

IEECMPMX (1052 Processor MCS) 

IEECLCTX (Console Switch MCS) 



^ ►IEECVPMC — Card Reader Processor (non-MCS) 

Chart : GR 

CSECT : IGC1107B 

Entry : IEECVPM 

Exit : IEECVCTX (Console Switch) 

IEECVOCC (Card Reader Open/Close) 
IEECVCTW (Wait routine) 

Modules Used : IEE0303D (Command Processor) 
IEAAWT00 (WAIT) 
IEAAMSOO (FREEMAIN) 

Function : Performs read operations for a 
card reader. 

^IEECVOCC — Card Reader Open/Close 

CSECT : IGC1I07B 

Entry : IEECVOC 

Exit : IEECVPMC (Card Reader Processor 
non-MCS) 

IEECVCTX (Console Switch non-MCS) 
IEECMPMC (Card Reader Processor MCS) 
IEECLCTX (Console Switch MCS) 

Modules Used : IEAAMSOO (GETMAIN) 

Function : Performs Open/Close functions 
for a card reader. 

^IEECVPMP — Printer Processor (non-MCS) 

CSECT : IGC2107B 

Entry : IEECVPM 

Exit : IEECVCTW (Wait routine) 

IEECVOCP (Printer Open/Close) 
IEECVCTX (Console Switch) 
IEECVPM1 (Non-MCS Load 2) 

Modules Used : IEAAMSOO (FREEMAIN) 

Function : Performs write operations to a 
printer. 

^ IEECVPMl — 1052 Processor Load 2 (non-MCS) 

CSECT : IGC0207B 

Exit : IEECVPMX (1052 Processor non-MCS) 
IEECVPMP (1052 Open/Close) 
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Modules Used ; EXCP f POST, FREEMAIN, XCTL, ^IEEMFWTO (MCS) and IEENFWTO (non-MCS) WTO 
WAIT Service Routines 



Tables/Work Areas : WQE, UCM, XSA, DCBD 

Function : Processes multiple-line WTO mes- 
sages for 1052 consoles and printer con- 
soles- It also rings the audible alarm on 
the 1052 console when a permanent I/O error 
occurs. 



^ ►IEECVOCP — Printer Open/Close 
CSECT: IGC2I07B 



Entry : IEECVOC 



Exit: 



IEECVPMP 
IEECVCTX 
IEECMPMP 
IEECLCTX 



(Printer Processor non-MCS) 

(Console Switch non-MCS) 

(Printer Processor MCS) 

(Console Switch MCS) 



Chart : GC 



CSECT : IGC0003E 

Exit : IEANTM00 (ABEND) 
IEEVWTOR 
IEECVML1 
IEECVML3 

Modules Used : GETMAIN 
WAIT 
ENQ/DEQ 
POST 

Tables/Work Areas : CVT, USM, WQE, RQE, EIL 

Function : This routine provides buffer 
management for the WTO macro instruction. 
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COMMUNICATIONS TASK WITH MULTIPLE CONSOLE 
SUPPORT 



2>IEECMAWR — Communications Task Router 



(MCS) 



Modules Used : IEECMWSV (WTO Processor) 

Tables/Work Areas ; CVT„ UCM. 

Function : Constructs message indicating 
console switch and new attributes of 
console. 



Chart : 



GI 



CSECT : IEECMAWR 

Exit : IEECMCTR (Mini-Router) 

IEECMDSV (Device Interface) 

IEECMWSV (WTO Processor) 

IEECMWTL (NIP Message Buffer Writer) 

IEECMDOM (Delete Operator Message) 

Modules Used : IEAAWTOO (WAIT) 

Tables/Work Areas : UCM 

Function : Determines from the list of ECBs 
the function to be performed and passes 
control to the appropriate routine. 



P> IEECNCTX — Communications Task Console 
Switch Load 3 (MCS) 

Chart : GJ 

CSECT : IGCXN07B 

Exit: IEECMAWR 



Tables/Work Areas : CVT ff UCM. 

Function : Move RQEs and WQEs from queue of 
old console to that of new. 



[v> IEECMCTR — Communications Task Mini-Router 
(MCS) 

CSECT : IGC0007B 

Exit : IEECLCTX (Console Switch) 

IEECMPMx (Device processor indicated 
by V) 



Function : Passes control to the appropri- 
ate nonresident routine as indicated by the 
Router. The nonresident routines must 
receive control from a routine operating 
under control of an SVRB. 



fe> IEECOCTX — Communications Task Console 
Switch Load 4 (MCS) 

Chart : GJ 

CSECT : IGCXO07B 

Exit : IEECMAWR (Router) 

IEECMCTX (Console Switch Load 2) 

Tables/Work Areas : CVT, UCM. 

Function : Switches the hard copy log to an 
active, nongraphic console. 



►IEECLCTX — Communications Task Console 
Switch Load 1 (MCS) 

Chart : GJ 

CSECT : IGCXL07B 

Exit : IEECMAWR (Router) 

IEECMCTX (Console Switch Load 2) 
IEECOCTX (Console Switch Load 4) 

Tables/Work Areas : CVT f UCM r CXSA. 

Function : Switches consoles from master or 
primary to alternate. 



► IEECMCTX — Communications Task Console 
Switch Load 2 (MCS) 



►IEECMDSV — Communications Task Device 
Interface (MCS) 



Chart: 



CSECT: 



Exit: 



GK 



IEECMDSV 



IEECMAWR (Router) 
IEECMCTR (Mini-Router) 



Modules Used: 



IEAAMSOO (FREEMAIN) 

IEAAPTOO (POST) 

IEEVL03F (Write-to-Log) 

IEECMWSV (WTO Processor) 

IEECLCTX (Console Switch 
Load 1) 



Function : Passes control to the device 
processor routines through the Mini-Router; 
provides queue management for console and 
system output queues. 



Chart: 



GJ 



CSECT : IGCXM07B 

Exit: IEECNCTX (Console Switch Load 3) 



► IEECMWSV — Communications Task WTO/R 
Processor (MCS) 



Chart : GL 
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CSECT: IEECMWSV 



Exits: IEECMPMX (1052 Processor Load 1) 



Exit : IEECMAWR (Router) 

Modules Used : IEECMDSV (Device Interface) 
IEAASY00 (SYNCH) 
IEAAMS00 (GETMAIN) 

Tables/Work Areas : CVT, UCM. 

Function : Places WQEs on appropriate con- 
sole output queues. fe 



> IEECMDOM — Communications Task Delete 
Operator Message (MCS) 

Chart : GM 

CSECT : IEECMDOM 

Exit : IEECMAWR (Router) 

Modules Used : IEAAMS00 (FREEMAIN) 

IEECMCTR (Mini-Router) 

Function : Indicates specified messages 
that are to be deleted. 

>IEECMWTL — Communications Task NIP Message 
Buffer Writer (MCS) 

Chart : GN 

CSECT : IGC0907B 

Exit : IEECMAWR 

Modules Used : IEECVWTO (Write-to-Operator) 
IEE0303F (Write-to-Log) 

Function : Writes NIP messages to the sys- 
tem log or the operator. 



Modules Used : EXCP 

Tables/Work Areas : WQE f UCM, UCME, XSA 

Function : This routine writes the lines of 
a multiple-line WTO on a 1052 console. 



►IEECMPMC — Card Reader Processor (MCS) 

Chart : GS 

CSECT : IGC1107B 

Entry : IEECVPM 

Exit : IEECMDSV (Device Interface) 

IEECVOCC (Card Reader Open/Close) 

Modules Used : IEAAMS00 (GETMAIN/ FREEMAIN) 
IEE1403D (Log) 

Function : Performs read operations for a 
card reader, 

>IEECMPMP — Printer Processor (MCS) 

CSECT : IGC2107B 

Entry : IEECVPM 

Exit : IEECVOCP (Printer Open/Close) 
IEECMDSV (Device Interface) 
IEECLCTX (Console Switch Load 1) 

Modules Used : IEAAMS00 (GETMAIN) 

Function : Performs write operations to a 
printer. 



►IEECMPMX — 1052 Processor Load 1 (MCS) 

Chart : GP 

CSECT : IGC0107B 

Entry : IEECVPM 

Exit : IEECLCTX (Console Switch Load 1) 
IEECMDSV (Device Interface) 
IEECVOCX (1052 Open/Close) 
IEECMPM1 (1052 Processor Load 2) 

Modules Used : IEAAMS00 (GETMAIN/FREEMAIN) 
IEE0303D (Command Processor) 

Function : Performs read and write opera- 
tions to a 1052 console. 

frIEECMPMl — 1052 Processor Load 2 (MCS) 
CSECT: IGC0207B 



> IEECVML1 — Non-MCS Multiple-line WTO 
Processor (Load 1) 

CSECT : IEECVML1 

Exits : IEECVML2, IEECVML4 

Modules Used : XCTL, SVC 7 

Tables/Work Areas : XSA, UCM, WQE, JSCB, 
TCB, RB 

Function : This routine builds the major 
WQE for multiple- line WTO requests (for 
non-MCS systems) . 



fe> IEECVML2 — Non-MCS Multiple-line WTO 
(Load 2) 

CSECT : IEECVML2 

Exits : IEECVML4 
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Tables/Work Areas : WQE, UCM, XSA 

Function ; This routine builds the minor 
WQEs for the multiple-line WTO requests 
(non-MCS systems) . 



►IEECVML6 — MCS Multiple-line WTO Processor 
(Load 3) 



CSECT: 



IEECVML6 



^ ►IEECVML3 — MCS Multiple- line WTO Processor 
(Load 1) 

CSECT : IEECVML3 

Exits : IEECVML5, IEECVML6 

Modules Used : XCTL, SVC 7 

Tables/Work Areas : XSA, UCM f WQE f JSCB, 
TCB, RB 

Function : This routine builds the major 
WQE for a multiple-line WTO request. 

^ 1EECVML4 — Non-MCS Multiple-line WTO 
Processor (Load 3) 

CSECT : IEECVML4 

Exit : IEECVML1 
IEECVML2 
return to caller 

Tables/Work Areas : XSA, UCM, WQE 

Modules Used : XCTL, POST, ENQ/DEQ, GETMAIN 

Function : This routine obtains WQE buffer 
space and queues the major and minor WQEs 
for multiple- line WTO requests (non-MCS 
systems) . 



Exit : IEECVML7 
IEECVML5 
IEECVML3 
return to caller 

Modules Used : XCTL, POST, ENQ/DEQ, GETMAIN 

Function : This routine obtains WQE buffer 
space and queues the major and minor WQEs 
for multiple-line WTO requests. 



^ ►IEECVML7 — MLWTO Load 7 (MCS) 

Chart : GD 

CSECT : IEECVML7 

Exit : Return to SVC 3 issuer 

Modules Used : IEAGENQ1 (DEQ) 

Function : Removes request from the WQE 
resource request queue and sets return 
code. 



^> IEECVML5 — MCS Multiple-line WTO Processor 
(Load 2) 

CSECT : IEECVML5 

Exits : IEECVML6 

Tables/Work Areas : WQE, UCM, XSA 

Function : This routine builds minor WQEs 
for multiple- line WTOs. 



^IEEC2740 — 2740 Processor (MCS only) 
Chart : GT 
CSECT : IEEC2740 
IEECVPM 



Entry : 
Exit: 



IEECMDSV (Device Interface) 
IGG019MA (BTAM read/write) 
IEECLCTX (Console Switch) 



Modules Used : 



IEAATC00 (LOAD) 
IEAAMS00 (GETMAIN) 



Function : Performs open and close func- 
tions for the 2740 console. 
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TIMER SUPERVISION 

^► IEAORTOO — TIME Service 

Chart ; HA 

CSECT : IGC011 

Exit : IEA0XE00 (Type 1 SVC Exit) 

Function ; Returns the date and time of 
day, 

IEA0ST00 — TTIMER Service 

Chart : HC 

CSECT : IGC047 

Entry : IGC046 

Exit : IEAATAOO (EXIT) 

Modules Used : IEAQTDOO (Timer DEQ in 
IEA0TI02) 

Function: Returns the amount of time 
remaining in a time interval or cancels a 
specified time interval. 

I ^IEAOSTOO — STIMER Service 

Chart : HD 

CSECT : IGC047 

Exit : IEAATAOO (EXIT) 

Modules Used : IEAAWTOO (WAIT) 
IEAAMS (GETMAIN) 
IEAQTDOO (Timer DEQ in 
IEA0TI00) 

IEAQTEOO (Timer ENQ in 
IEA0TI00) 

Function : Creates a TQE for a specified 
time interval. 

^ ►IEAOTIOO — Timer SLIH 

Chart : HB 

CSECT : IEAOTIOO 

Exit : DISMISS (in IEAAIHOO) 

Modules Used : IEAAPTOO (POST) 

IEA0EF00 (Stage 2 Exit 

Effector) 

IEAQTEOO (Timer ENQ in 

IEAOTIOO) 

IEA0AB00 (ABTERM) 

Function : Processes timer interruptions. 

^IEAOTIOO — Timer ENQ/DEQ 

I Chart : HB 



CSECT : IEAOTIOO 

Entry : IEAQTDOO (DEQ) 
IEAQTEOO (ENQ) 

Exit : Return to caller. 

Function : Provides queue management for 
TQEs and the timer queue. 

^ IEAORTOl — TIME Service with System/370 
Time-of-Day Clock 

Chart : HE 

CSECT : IGC011 

Exit : IEA0XE00 (Type 1 SVC Exit) 

Modules Used : IEA0VL00 (Validity Check) 

Function : Returns date and time of day. 

^> IEA0ST01 — TTIMER Service with System/370 
Time-of-Day Clock 

Chart : HF 

CSECT : IGC047 

Entry : IGC046 

Exit : IEA0XE00 (Type 1 SVC Exit) 

Modules Used : IEAAMS (FREEMAIN) 

IEAQTDOO (Timer DEQ) 

jte HEAOSTOl — STIMER with System/370 
Time-of-Day Clock 

Chart : HG 

CSECT : IGC047 

Exit : IGC003 (EXIT) 

Modules Used : IEAAMS (GETMAIN) 

IEAQTEOO (Timer ENQ) 
IEAAAWTOO (WAIT) 



ftfr- IEA0TIQ3 — Timer SLIH with System/370 
Time-of-Day Clock 

Chart : HH 

CSECT : IEAOTIOO 

Exit : DISMISS (in IEAAIHOO) 

Modules Used : IEAAPTOO (POST) 

IEAOEFOO (Stage 2 Exit 

Effector) 

IEAQTEOO (Timer ENQ) 

IEA0AB00 (ABTERM) 
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DIDOCS 



^IGC5A07B — DIDOCS Options 

Chart ; JP 

CSECT ; IEECVETA 

Exit ; IGC5D07B (Message 1) 

IGC5H07B (M85 I/O) 

IGC5J07B (Roll Mode) 

IGC5K07B (Timer Interpreter) 

IGC5P07B (2250 I/O) 

IGC5R07B (2260 I/O) 

Tables/Work Areas ; UCM 

Function ; Ensures validity of selected 
options and records the selected options in 
the Display Control Module. 

^► IGC5C07B — DIDOCS Asynchronous Error 

Chart ; KC 

CSECT ; IEECVETC 

Exit ; IGCXL07B (Console Switch) 

IGC5D07B (Message 1) 

IGC5E07B (Message 2) 

IGC5H07B (M85 I/O) 

IGC5K07B (Timer Interpreter) 

IGC5P07B (2250 I/O) 

IGC5R07B (2260 I/O) 

IGC6G07B (Cleanup) 

Tables/Work Areas ; DCM 

Function ; This routine processes requests 
for reopening a device and asynchronous I/O 
errors for display consoles. 

^ IGC5D07B — DIDOCS Message 1 

Chart ; JH 

C SECT ; IEECVETD 

Exit ; IGC5H07B (M85 I/O) 

IGC5P07B (2250 I/O) 

IGC5R07B (2260 I/O) 

IGC5107B (Processor) 

IGC5307B (Display 2) 

Tables/Work Areas ; DCM 

Function ; Places error or informational 
messages into appropriate line. 



Exit ; IGC5H07B (M85 I/O) 
IGC5P07B (2250 I/O) 
IGC5R07B (2260 I/O) 

Tables/Work Areas ; DCM 

Function ; Places error messages into the 
appropriate line. 



> IGC5F07B — Light Pen/Cursor 
Chart; JU 



CSECT; IEECVETF 



Exit; 



IGC5D07B 
IGC5E07B 
IGC5H07B 
IGC5L07B 
IGC5P07B 
IGC5R07B 
IGC5407B 
IGC5807B 
IGC5907B 
IGC6A07B 



(Message 1) 

(Message 2) 

(M85 I/O) 

(Status Display 1) 

(2250 I/O) 

(2260 I/O) 

(Command) 

(Delete 3) 

(Delete 4) 

(PFK 1) 



^► IGC5E07B — DIDOCS Message 2 
Chart: JI 
CSECT; IEECVETE 



Tables/Work Areas ; DCM 

Function ; Determines validity of light pen 
or cursor interruption. 

> IGC5G07B — DIDOCS Open/Close 

Chart ; KK 

CSECT : IEECVETG 

Exit ; IEECMDSV (Device Interface) 

IGCXL07B (Console Switch) 

IGC5K07B (Timer Interpreter) 

IGC5107B (Processor) 

Tables/Work Areas : DCM 

Function : Performs open and close func- 
tions for specified consoles. 



> IGC5H07B — DIDOCS Model 85 I/O 

Chart : JG 

CSECT : IEECVETH 

Exit : IGC5F07B (Light Pen/Cursor) 
IGC5107B (Processor) 

Tables/Work Areas : DCM 

Function : Initiates requested I/O to the 
Model 85 Operator's Console. 



►IGC5J07B — DIDOCS Roll Mode 



Chart: JN 
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CSECT: IEECVETJ 

Exit : IGC5K07B (Timer Interpreter) 
IGC5107B (Processor) 
IGC5207B (Display 1) 

Tables/Work Areas ; DCM 

Function: Rolls the screen buffer. 



[^> IGC5K07B — DIDOCS Timer Interpreter 

Chart : JV 

CSECT : IEECVETK 

Exit : IGC5D07B (Message 1) 

IGC5E07B (Message 2) 

IGC5G07B (Open/Close) 

IGC5H07B (M85 I/O) 

IGC5P07B (2250 I/O) 

IGC5R07B (2260 I/O) 

IGC5107B (Processor) 

IGC5207B (Display 1) 

Tables/Work Areas : DCM 

Function : Determines the time intervals 
for rolling each console. 

[> IGC5P07B — DIDOCS 2250 I/O 1 

Chart : JC 

CSECT : IEECVETP 

Exit : IGC5F07B (Light Pen/Cursor) 
IGC5Q07B (2250 I/O 2) 
IGC5107B (Processor) 

Tables/Work Areas : DCM 

Function : Initiates I/O to a 2250 
console, 

[> IGC5Q07B — DIDOCS 2250 I/O 2 
Chart : JD 
CSECT : IEECVETQ 
Exit : IGC5107B (Processor) 
Tables/Work Areas : DCM 
Function: Initiates I/O to a 2250 console. 



Exit : IGC5F07B (Light Pen/Cursor) 
IGC5107B (Processor) 
IGC5407B (Command) 

Tables/Work Areas : DCM 

Function: Initiates I/O to a 2260 console. 



j^ >IGC5Z07B — DIDOCS Processor l ff Load 2 

Chart: JB 

CSECT : IEECVETZ 

Exit : IGC5107B (Device- dependent I/O 
routine) 
IGC5G07B (Open/Close routine) 
IGC5H07B (Model 85 I/O routine) 
IGC5P07B (2250 I/O routine) 
IGC5R07B (2260 I/O routine) 



Tables/Work Areas: 



DCM 



Function : Continues processing begun by 
Processor 1„ Load 1, 

[> IGC5107B — DIDOCS Processor 1„ Load 1 
Chart: JA 



CSECT : IEECVET1 

Exit : IEECMAWR 

IGC5C07B 
IGC5D07B 
IGC5F07B 
IGC5G07B 
IGC5H07B 
IGC5J07B 
IGC5K07B 
IGC5P07B 
IGC5R07B 
IGC5207B 
IGC5407B 
IGC5707B 
IGC5907B 
IGC6M07B 

IGC6107B 
IGC6A07B 



(Communications Task 

Router) 

(Asynchronous Error) 

(Message 1) 

(Light Pen/Cursor) 

(Open/Close) 

(M85 I/O) 

(Roll Mode) 

(Timer Interpreter) 

(2250 I/O) 

(2260 I/O) 

(Display 1) 

(Command) 

(Delete 2) 

(Delete 4) 

(Status Display 

Interface 2) 

(Processor 0) 

(PFK 1 Routine) 



Tables/Work Areas : DCM 

Function : Determines processing required 
and passes control to the appropriate 
module. 



p> IGC5R07B — DIDOCS 2260 I/O 1 
Chart: JE 



CSECT: IEECVETR 



f >IGC52Q7B — DIDOCS Display 1 
Chart : JK 
CSECT: IEECVET2 



Module Synopses 167 



Exit ; IGC5D07B (Message 1) 

IGC5M07B (Display Status 2) 

IGC5107B (Processor) 

IGC5307B (Display 2) 

IGC5707B (Delete 2) 

IGC5907B (Delete 4) 

IGC6207B (Display 3) 

Tables/Work Areas : DCM 

Function ; Displays messages and marks 
those that require action or may be 
deleted. 



IGC5R07B (2260 I/O) 
IGC5907B (Delete 4) 

Tables/Work Areas ; DCM 

Function : Analyzes requests for deletion 
of messages. 

^IGC5707B — DIDOCS Delete 2 
Chart: JR 



^ »IGC5307B — DIDOCS Display 2 

Chart : JL 

CSECT : IEECVET3 

Exit : IGC5D07B (Message 1) 
IGC5107B (Processor) 
IGC5207B (Display 1) 
IGC5707B (Delete 2) 
IGC5907B (Delete 4) 
IGC6207B (Display 3) 

Tables/Work Areas : DCM 

Function : Indicates accepted reply message 
by vertical bar. 

^IGC5407B — DIDOCS Command 

Chart : JO 

CSECT : IEECVTE4 

Exit : IGC5A07B (Options) 

IGC5C07B (Asynchronous Error) 
IGC5D07B (Message 1) 
IGC5E07B (Message 2) 
IGC5H07B (M85 I/O) 
IGC5L07B (Status Display 1) 
IGC5P07B (2250 I/O) 
IGC5R07B (2260 I/O) 
IGC5607B (Delete 1) 
IGC5807B (Delete 3) 
IGC5907B (Delete 4) 

Tables/Work Areas : DCM 

Function : Determines command type; pro- 
cesses CANCEL commands. 



CSECT : IEECVET7 

Exit : IGC5H07B (M85 I/O) 
IGC5P07B (2250 I/O) 
IGC5R07B (2260 I/O) 
IGC5107B (Processor) 
IGC5907B (Delete 4) 

Tables/Work Areas : DCM 

Function : Processes intervention-required 
messages. 

^IGC5807B — DIDOCS Delete -3 
Chart : JS 
CSECT: IEECVET8 



Exit: 



IGC5D07B 
IGC5E07B 
IGC5H07B 
IGC5P07B 
IGC5R07B 
IGC5907B 



(Message 1) 
(Message 2) 
(M85 I/O) 
(2250 I/O) 
(2260 I/O) 
(Delete 4) 



^ ►IGC5607B — DIDOCS Delete 1 

Chart : JQ 

CSECT : IEECVET6 

Exit : IGC5D07B (Message 1) 
IGC5E07B (Message 2) 
IGC5H07B (M85 I/O) 
IGC5P07B (2250 I/O) 



Tables/Work Areas : DCM 

Function : Analyzes deletion of messages 
requested by light pen f cursor, or K E f SEG 
command 



^ IGC5907B — DIDOCS Delete 4 

Chart : JT 

CSECT : IEECVET9 

Exit : IGC5D07B (Message 1) 

IGC5H07B (M85 I/O) 

IGC5P07B (2250 I/O) 

IGC5R07B (2260 I/O) 

IGC5207B (Display 1) 

Tables/Work Areas : DCM 

Function : Removes messages for regular or 
automatic delete requests. 

^► IGC6A07B — DIDOCS PFK 1 
Chart: KL 
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CSECT: 



IEECVFTA 



» IGC6L07B — DIDOCS Status Display 
Interface 1 



Exit : IGC6D07B (Message 3) 

IEECVET1 (Processor 1, Load 1) 

Tables/Work Areas: DCM 



Chart: KD 



CSECT: IEECVFTL 



Function : Analyzes and enters commnnds 
requested by a PFK key or a selector pen 
detection of a displayed PFK number. 



^ IGC6B07B — DIDOCS PFK 2 
Chart : KM 
CSECT: IEECVFTB 



Exit : IGC6D07B (Message 3) 
IEECVFTD (PFK 2) 
IEECVET1 (Processor 1, 

Tables/Work Areas: DCM 



Load 1) 



Exit : IGC5D07B (Message 1) 

IGC5H07B (M85 I/O Routine) 

IGC5P07B (2250 I/O Routine) 

IGC5R07B (2260 I/O Routine) 

IGC5107B (Processor 1, Load 1) 

IGC5207B (Display 1) 

IGC6207B (Display 3) 

Modules Used : XCTL 

Tables/Work Areas : CXSA, UCM, WQE r DCM 

Function : This routine displays multiple- 
line WTOs in the message area of a display 
console screen. 



Function : Processes operator requests to 
define or redefine the commands associated 
with a PFK key; to write or erase the PFK 
display line on the screen. 



^> IGC6D07B — DIDOCS Message 3 
Chart : JJ 

IEECVFTD 



►IGC6M07B — DIDOCS Status Display 
Interface 2 



CSECT: 



Exit: 



IEECVETH (Model 85 I/O Routine) 
IEECVETP (2250 I/O Routine) 
IEECVETR (2260 I/O Routine) 



Tables/Work Areas : DCM 

Function : Writes error messages in the 
instruction line of display consoles. 



fl^ IGC6G07B — DIDOCS Cleanup- Routine 
Chart : KN 

IEECVFTG 



CSECT: 



Exit: 



IGC5C07B (Asynchronous Error) 
Return to Caller 



Modules Used: 



FREEMAIN 



Chart: 



KE 



CSECT : IEECVFTM 

Exit : IGC6O07B (Status Display 

Interface 4) 
IGC6Q07B (Status Display 

Interface 6) 
IGC6P07B (Status Display 

Interface 5) 
IGC5107B (Processor 1, Load 1) 

Tables/Work Areas : UCM, Resident portion 
of the DCM (including the SACBs) f Transient 
portion of the DCM 

Function : This routine is the control 
module for out-of-line status displays 
(status displays to be presented in a dis- 
play area on a display console screen) . It 
initializes the screen area control blocks 
(SACBs) in the DCM and routes control to 
the appropriate module to process the sta- 
tus display. 



►IGC6N07B — DIDOCS Status Display 
Interface 3 

Chart: KF 



Tables/Work Areas : UCM, Resident portion 
of the DCM (including the SACBs) , Transient 
portion of the DCM 

Function : This routine dequeues status 
displays and reinitializes the SACBs when a 
device status change is requested or when 
an asynchronous error occurs. 



CSECT : IEECVFTN 

Exit : IGC5H07B (M85 I/O Routine) 
IGC5P07B (2250 I/O Routine) 
IGC5R07B (2260 I/O Routine) 

Modules Used : SVC 34 , XCTL 
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Function ; This routine processes CONTROL 
commands affecting out-of-line status dis- 
plays (CONTROL D,H; CONTROL D,U; CONTROL 
D f F) 



>!GC6O07B 



DIDOCS Status Display 



Interface 4 



Chart : KG 

CSECT : IEECVFTO 

Exit : IGC5H07B (M85 I/O Routine) 
IGC5P07B (2250 I/O Routine) 
IGC5R07B (2260 I/O Routine) 

Modules Used : SVC 34, XCTL 

Function : This routine moves the display 
into the DCM and passes control to the I/O 
routine to write the display to the screen 
(for displays that overlay other messages 
on the screen) . 



Function : This routine moves the display 
into the DCM message area buffer and passes 
control to the I/O routine to write the 
display to the screen- This routine is 
used for displays that do not overlay other 
messages on the screen. 



> IGC6R07B — 2260 I/O 2 

Chart : JF 

CSECT : IEECVFTR 

Exit: IGC6G07B (Cleanup) 

IGC5K07B (Timer/Interpreter) 

IGC5R07B (2260 I/O 1) 

IEECVET1 (Processor 1, Load 1) 

Tables/Work Areas : DCM 

Function : Switches console status from 
full-capability mode to output-only mode, 
from one output-only mode to the other, and 
from output-only mode to full- capability 
mode for 2260 operator's consoles. 



> IGC6P07B — DIDOCS Status Display 
Interface 5 



Chart: 



KH 



> IGC6T07B — DIDOCS Status Display 
Interface 7 



CSECT: IEECVFTP 



Chart: KJ 



Exit : IGC5H07B (M85 I/O Routine) 
IGC5P07B (2250 I/O Routine) 
IGC5R07B (2260 I/O Routine) 
IGC6M07B (Status Display 
Interface 2) 

Modules Used : SVC 34, XCTL 

Tables/Work Areas : UCM, DCM, WQE 

Function : This routine handles CONTROL 
commands affecting out-of-line status dis- 
plays (CONTROL E,D) and the STOPMN A 
command. 



> IGC6Q07B — DIDOCS Status Display 
Interface 6 

Chart : KI 

CSECT: IEECVFTQ 



Exit : IGC5H07B (M85 I/O Routine) 
IGC5P07B (2250 I/O Routine) 
IGC5R07B (2260 I/O Routine) 
IGC6M07B (Status Display 
Interface 2) 

Tables/Work Areas : UCM, Resident portion 
of the DCM (including the SACBs), Transient 
portion of the DCM 



CSECT : IEECVFTT 

Exit : IGC5H07B (M85 I/O Routine) 
IGC5P07B (2250 I/O Routine) 
IGC5R07B (2260 I/O Routine) 

Modules Used : XCTL 

Tables/Work Areas : UCM, DCM 

Function : This routine blanks message area 
lines below status displays. 

|^> IGC6Z07B — Processor 0, Load 2 

Chart : KB 

CSECT : IEECVFTZ 

Exit : IGC5107B (Processor 1, Load 1) 

Tables/Work Areas : DCM, UCM Entry 

Function : Checks I/O complete for tran- 
sient DCM switching. 



►IGC6107B 



Processor 0, Load 1 



Chart: KA 



CSECT: IEECVFT1 
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Exit : IGC5107B (Processor 1, Load 1) CSECT : IEECVFT2 
IGC6Z07B (Processor 0, Load 2) 

Exit : IGC5307B (Display 2) 
Tables/Work Areas : DCM IGC5207B (Display 1) 

IGC6L07B (Status Display 
Function : Brings transient portion of DCM Interface 1) 

into main storage. 

Tables/Work Areas : CXSA, WQE, DCM, UCM 

Function : This routine continues proces- 
P> IGC6207B — DIDQCS Display 3 sing from Display 2. It displays warning 

messages and marks action and deletable 
Chart : JM messages. 
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FLOWCHARTS 



The flowcharts are arranged in the order 
in which the modules are described in this 
publication. Each logical flowchart is 
assigned an alphabetic ID by which it is 
referenced elsewhere in the flowcharts , 
text, and tables. Each logical flowchart 
may be comprised of several pages of flow- 
charts which together describe the sequence 
of processing within the module. 
References to the pages that make up the 
logical flowchart appear in the following 
format : 

AA/N/BB 



BB 



is the block reference on page N of 
logical chart AA. 



where: 
AA 

N 



is the logical chart ID. 



is the sequential page number within 
the logical flowchart AA. 



The first letter of each flowchart indi- 
cates the type of supervisor module being 
described: 



A — Interruption Supervision 

B — Task Supervision 

C,D — Task Termination 

E — Contents Supervision 

F — Main Storage Supervision 

G — Communications Task 

H — Timer Supervision 

I — Overlay Supervision 

J,K — Device Independent Display Operator 

Console Support 
L — Checkpoint/Restart 
M — Special Features 
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Chart AA. SVC First-Level Interruption Handler and Type 1 SVC Exit 



f SVC FLIH \ 



(^ N 

fTYPE 1 SVC EXITJ 



********************* 

TYPE 1 SVC ROUTINES* 
********************* 

WAIT * 

POST * 

GETMAIN * 

FREEMAIN * 

TIME * 

CHAP * 

TTIMER * 
********************* 



SAVE REGS IN 

TYPE 1 SAVE 

AREA 



RESET TYPE 1 

INDICATOR 

RESTORE REGS 

2-14 



TRACE SVC 



RECORD SVC 

INTERRUPTION IN 

TRACE TABLE 




PUT ERROR SVC 

IN FORMAT 

RESTORE REGS 8, 




STORE REGS 1 , 

10-15 IN TCB. 

SAVE SVC OLD 

PSW IN CUR. RB 



SET REG 3= 

ADDRESS OF CVT, 

REG 4 = CURRENT 

TCB, REG 5= 

CURRENT RB 



( ABEND J f DIS: 



DISPATCHER 



) 




TEST FOR SVC 

TYPE (2, 3, OR 

4 



SVC ROUTINE 


' 


f 


( SVC SLIH J 

EP: SVE 
CHART AB 


PROCESS TYPE 1 
SVC 


L 
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Chart AB. SVC Second-Level Interruption Handler (Part 1 of 2) 



* TYPE 2 SVC ROUTINES * 



Lum. LOAD, XCTL 

SYNCH 

CIRB 

DELETE 

DETACH 

EXIT 

SEGLD 

SEGWT 

CIRB 

STIMER 

TYPE 3 SVC ROUTINES 
******************* 

ATTACH 

EXTRACT 

IDENTIFY 

SPIE 

STAE 



TYPE 4 SVC ROUTINES 

ABDUMP 

ABEND 

CHECKPOINT RESTART 

COMMUNICATIONS 

TASK & SYSTEM LOG 



WTOR 
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Chart AB. SVC Second-Level Interruption Handler (Part 2 of 2) 




SVC ROUTINE 



G 



3 



LOAD ROUTINE 
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Chart AC. EXIT (Type 2, 3, and 4 SVC Routines) (Part 1 of 2) 



f EXIT J 



ENTERED VIA SVC 3 
FROM TYPES 2. 3, 
AND 4 SVC ROUTINES 
OR VIA BRANCH 
FROM SVC SLIH 



SAVE REGS IN 
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Chart AC. EXIT (Type 2, 3, and 4 SVC Routines) (Part 2 of 2) 
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Chart AD. Input/Output First-Level Interruption Handler and Timer /External First- Level 
Interruption Handler 
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Chart AE. Program-Check First-Level Interruption Handler and System Wait Time Collection 
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Chart AF. Dispatcher (Part 1 of 2) 
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Chart AF. Dispatcher (Part 2 of 2) 
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Chart AG. SERO Routine 
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Chart AH. SER1 Routine 
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Chart AI. Extended SVC Router Routines 
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Chart BA, ATTACH with the Subtasking Option (Part 1 of 2) 
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Chart BA. ATTACH with the Subtasking Option (Part 2 of 2) 
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Chart BB. DETACH 
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Chart BC. 
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Chart BD. EXTRACT without the Subtasking Option 
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Chart BE. EXTRACT with the Subtasking Option 
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Chart BG. POST 
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Chart BH. ENQ (Part 1 of 2) 
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Chart BH. ENQ (Part 2 of 2) 
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Chart BJ. DEQ (Part 1 of 2) 
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Chart BJ. DEQ (Part 2 of 2) 
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Chart BK. SPIE 
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Chart BL. 
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Chart BM. Stage 1 Exit Effector 
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Chart BN. Stage 2 Exit Effector 
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Chart BO, Stage 3 Exit Effector 
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Chart CA. ABEND 
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Chart CB. ABEND G (Part 1 of 2) 
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Chart CB. ABEND G (Part 2 of 2) 
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Chart CC. ABEND 1 
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Chart CD. ABEND 2 and ABEND 3 
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Chart CE. ABEND 4 
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Chart CF. ABEND 5 
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Chart CH. ABEND 7 and ABEND 8 
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Chart CI. ABEND 9 
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Chart CJ. ABEND 10 
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Chart CK. ABEND 11, ABEND 12, and ABEND 13 
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Chart CL. ABEND 14 



r~" N 

f ABEND 14 J 



FROM ABEND 15 CHART CM 




DEQRB 



DEQUEUE ALL RBS 

EXCEPT ABEND'S 

SVRB 



FREEMAIN FA 



GOES AND 

ASSOCIATED 

STORAGE 



( EXIT J 




DEQUEUE THE DEB 



GET NEXT DEB 




G 



} 



214 



Chart CM. ABEND 15 
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Chart CR. ABEND/STAE Interface Routine 2 



I ASIR 2 J 



FROM ASIR 1 CHART CQ 



GET ADDRESSES 

OF DEB + 

ABENDING PGM'S 




f ASIR 4 J 




GET DCB 

ASSOCIATED WITH 

THIS DEB 




r^ 3 "\ 

►f ABEND 1 1 1 



TO PURGE WTOR 
REPLY QUEUE 



CLOSE 

CLOSE 



DEQUEUE IOBS 

FROM RESTORE 

CHAIN 



u 



© 



TURN ON 

ISAM/TAM SWITCH 

IN THE SCB 



L 







220 



Chart CS. ABEND/STAE Interface Routine 3 



ftb'i'M I J 

r~ M n 

f ASIR 3 1 




-XwORK AREA^N. \ 




SET RBOPSW OF 
STAE USER TO 
RETRY ROUTINE 



NOTE 1 : ZERO IN REGISTER 

WORK AREA ADDRESS IN REGISTER 1 
RETRY ADDRESS IN REGISTER 15 



CODE IN REGISTER 
COMPLETION CODE IN REGISTER 1 
I/O BLOCK ADDRESS IN REGISTER 2 
RETRY ADDRESS IN REGISTER 15 



Flowcharts 221 



Chart CT. ABEND/STAE Interface Routine H 
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Chart CU. Damage Assessment Routine 1 
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Chart CV. Damage Assessment Routine 2 
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Chart CW. Damage Assessment Routine 3 
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Chart DA. SVC DUMP 1 (Part 1 of 2) 
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Chart DA. SVC DUMP 1 (Part 2 of 2) 
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Chart DB. SVC DUMP 2 
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Chart DD. ABDUMP 2 and ABDUMP 3 
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Chart DE. ABDUMP H 
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Chart DF. ABDUMP 5 and ABDUMP 6 
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Chart DG. ABDUMP 7 and ABDUMP 8 



I ABDUMP 7 J 



( ABDUMP 8 J 



ftflAUU4 

r~ M \ 

f ABDUMP 8 J 



MOVE EBCDIC 
TRANSLATE RTN 
TO WORK AREA 





PRINT GENERAL 

PURPOSE 

REGISTERS 



^" "\ 

f ABDUMP 9 \ 



Flowcharts 235 



Chart DH. ABDUMP 9, ABDUMP 10 , and ABDUMP 11 
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Chart DK. ABDUMP 14 
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Chart DL. TCAM: ABDUMP 1 and ABDUMP 2 
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Chart DM. TCAM: ABDUMP 3 and ABDUMP 4 
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Chart EA. ATTACH without Subtasking 
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Chart EB. LINK, LOAD, XCTL (Part 1 of 3) 








MINOR LPRB 



IS THIS AN\NO 
ATTACH 
REQUEST 



1 



SET EXIT 
ADDRESS IN REG 
14 IN RB TO SVC 

3 IN CVT 



-B5- 



PUT RB ON TCB 

QUEUE BETWEEN 

SVRB AND RB FOR 

CALLER. 

PROPAGATE PSW 



PROCESS STAE 
CONTROL BLOCKS 

IF XCTL WITH 
OPTION SELECTED 



f EXIT J 



r** ^\ 

► f ABEND J 



YES 


GETMAIN FA 




INITIALIZE 

DUMMY LPRB 

INACTIVE 


OBTAIN AREA FOR 
DUMMY LPRB 







L 



Flowcharts 243 



Chart EB. LINK, LOAD, XCTL (Part 2 of 3) 
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Chart EC. FINCH: Processing for LINK, LOAD, ATTACH, and Nontransient Area XCTL 
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Chart ED. FINCH: Processing for SVC and I/O Transient Area Requests (Part 1 of 2) 
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Chart ED, FINCH: Processing for SVC and I/O Transient Area Requests (Part 2 of 2) 
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Chart ED. Transient Area Loading Task within FINCH 
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Chart FA. GETMAIN/FREEMAIN (Part 1 of 3) 
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Chart FA. GETMAIN/FREEMAIN (Part 2 of 3) 
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Chart FA. GETMAIN/FREEMAIN (Part 3 of 3) 
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Chart GB. Communications Task External Interruption and Attention Handlers 
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Chart GC. Communications Task Write- to- Operator without MCS 
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Chart GD. Multiple- Line Write- to- Opera tor (MLWTO) (Part 1 of 4) 
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Chart GD. Multiple-Line Write-to-Operator (MLWTO) (Part 2 of 4) 
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Chart GD. Multiple-Line Write-to-Operator (MLWTO) (Part 3 of 4) 
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Chart GD. Multiple-Line Write-to-Operator (MLWTO) (Part 4 of 4) 
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Chart GE. Communications Task Write-to-Operator with Reply 
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Chart GF. Communications Task Wait Cnon-MCS) 
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Chart GG. Communications Task Router (non-MCS) 
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Chart GH. Communications Task Console Switch (non-MCS) 
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Chart GI. Communications Task Router (MCS) 
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Chart GJ. Communications Task Console Switch Load 1 (MCS) (Part 1 of 4) 
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Chart GJ. Communications Task Console Switch Loads 2 and 3 (MCS) (Part 2 of 4) 
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Chart GJ. Communications Task Console Switch Load 3 (MCS) (Part 3 of 4) 
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Chart GJ. Communications Task Console Switch Load 4 (MCS) (Part 4 of 4) 
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Chart GK. Communications Task Device Interface (MCS) (Part 1 of 3) 
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Chart GK. Communications Task Device Interface (MCS) (Part 2 of 3) 
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Chart GK. Communications Task Device Interface (MCS) (Part 3 of 3) 
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Chart GL. Communications Task WTO/R Processor (MCS) (Part 1 of 3) 
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Chart GL. Communications Task WTO/R Processor (MCS) (Part 2 of 3) 
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Chart GL. Communications Task WTO/R Processor (MCS) (Part 3 of 3) 



( ENQCNSLE 1 



FROM IEECMWSV 
CHART GL/2 



INCREMENT 

ROUTED COUNT 

FOR CALLER USE 




TO IEECMWSV 
CHART GL/2 
IEECMDSV 
CHART GK/2 



276 



Chart GM. Coiranuni cations Task Delete Operator Message (MCS) 
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Chart GN. Communications Task NIP Message Buffer Writer 
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Chart GO. Communications Task 1052 Processor (non-MCS) (Part 1 of 2) 
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Chart GO. Communications Task 1052 Processor (non-MCS) (Part 2 of 2) 
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Chart GP. Communications Task 1052 Processor Load 1 (MCS) (Part 1 of 2) 
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Chart GP. Communications Task 1052 Processor Load 1 (MCS) (Part 2 of 2) 
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Chart GQ. Communications Task 1052 Open/Close 
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Chart GR. Communications Task Card Reader Processor (non-MCS) 
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Chart GS. Conumuni cations Task Card Reader Processor (MCS) 
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Chart GT. Communications Task 2740 Processor (MCS only) (Part 1 of 2) 
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Chart GT. communications Task 2710 Processor (MCS only) (Part 2 of 2) 
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Chart GU. Communications Task Log Writer 
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Chart GV. Communications Task LOG, Write-to- Log (Load 1) 
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Chart GW. Communications Task LOG, Write-to-Log (Load 2) 
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Chart GX. 1052 Processor Load 2 (Part 1 of 2) 
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Chart GX. 1052 Processor Load 2 (Part 2 of 2) 
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Chart GY. Graphic Console Initialization 
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Chart HB. Timer Second- Level Interruption Handler (Part 1 of 2) 
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Chart HB. Timer Second-Level Interruption Handler (Part 2 of 2) 
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Chart HC. 
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Chart HD. STIMER 
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Chart HE. TIME with Time-of-Day Clock 
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Chart HF. TTIMER with Time-of-Day Clock 
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Chart HG. STIMER with Time-of-Day Clock 
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Chart HH. Timer Second-Level Interruption Handler with Time-of-Day Clock 
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Chart JA. DIDOCS Processor 1, Load 1 (Part 1 of 2) 
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Chart JA. DIDOCS Processor 1, Load 1 (Part 2 of 2) 
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Chart JB. DIDOCS Processor 1, Load 2 
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Chart JC. DIDOCS 2250 I/O 1 (Part 1 of 2) 
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Chart JC. DIDOCS 2250 I/O 1 (Part 2 of 2) 
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Chart JD. DIDOCS 2250 I/O 2 
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Chart JE. DIDOCS 2260 I/O 1 
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Chart JF. DIDOCS 2260 I/O 2 
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Chart JG. DIDOCS Model 85 I/O 
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Chart JH. DIDOCS Message 1 
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Chart Ji. DIDOCS Message 2 (Part 1 of 2) 
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Chart JI. DIDOCS Message 2 (Part 2 of 2) 
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Chart JJ. DIDOCS Message 3 
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Chart JK. DIDOCS Display 1 (Part 1 of 2) 
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Chart JK. DIDOCS Display 1 (Part 2 of 2) 
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Chart JL„ DIDOCS Display 2 (Part 1 of 2) 
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Chart JL. DIDOCS Display 2 (Part 2 of 2) 
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Chart JM. DIDOCS Display 3 (Part 1 of 2) 
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Chart JM- DIDOCS Display 3 (Part 2 of 2) 
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Chart JN. DIDOCS Roll Mode 
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Chart JO. DIDOCS Command 
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Chart JP. DIDOCS Options (Part 1 of 2) 



y- A1 ^^ 

f OPTIONS J 











•"YES 




("JL 






MDEL 


t 








YES 




INDICATE VALUE 






OPERAND 


POINTER 



>S. NOT 

y^ ^S. NO 

^TIMER PRESENT^ ► 

^V-^YES 



INDICATE NO 

TIMER ERROR 

MESSAGE 



Li 



E> 



SET TIMER 

INTERPRETER BIT 

AND MESSAGE 1 

ROUTINE BIT 



L 



© 



INDICATE VALUE 

AND UPDATE 
OPERAND POINTER 



Flowcharts 325 



Chart JP. DIDOCS Options (Part 2 of 2) 
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Chart JQ. DIDOCS Delete 1 (Part 1 of 2) 
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Chart JQ. DIDOCS Delete 1 (Part 2 of 2) 
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Chart JR. DIDOCS Delete 2 
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Chart JS. DIDOCS Delete 3 (Part 2 of 2) 
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Chart JT. DIDOCS Delete H 
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Chart JU. DIDOCS Light Pen/Cursor 
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Chart JV. DIDOCS Timer/ Interpreter (Part 1 of 2) 
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Chart JV. DIDOCS Timer/Interpreter (Part 2 of 2) 
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Chart KA. DIDOCS Processor Load 1 (Part 1 of 2) 
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Chart KA. DIDOCS Processor Load 1 (Part 2 of 2) 
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Chart KB. DIDOCS Processor Load 2 (Part 1 of 2) 
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Chart KB. DIDOCS Processor Load 2 (Part 2 of 2) 




READ COMPLETE 





L B 



© 




SAVE COUNT AND 
CCHHR IN WRITE 

ELEMENT 




I ' 

UPDATE CHANNEL 
I PROGRAM AND 
ELEMENT POINTER 



SET CERTAIN 
TRANSIENT DCM 
FLAGS IF ON IN 
RESIDENT DCM 



CONVERT 


' 




CONVERT 

RELATIVE TTR TO 

CCHHR 




ADJUST ALL 

TRANSIENT DCM 
ADCONS 



0- 



Ci 



L 



C— K 
PRO( 



D 



Flowcharts 339 



Chart KC. DIDOCS Asynchronous Error (Part 1 of 2) 
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Chart KC. DIDOCS Asynchronous Error (Part 2 of 2) 
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Chart KD. DIDOCS Status Display 1 
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Chart KE. DIDOCS St at lis Display 2 (Part 1 of 2) 




INDICATE 
BLANKING MUST 
BE CHECKED 



SAVE 

INFORMATION 

ABOUT THE TOP 

DISPLAY 



r 



CLEAR 
CORRESPONDING 
PORTION OF SSCT 










- 'YES / \ 



•0 



TURN OFF 

OUT-OF-LINE 

OUTPUT PENDING 

FLAG 



• 





INITIALIZE SACB 

FOR THIS 

DISPLAY 




INITIALIZE SACB 

AND SSCT FOR 
DYNAMIC DISPLAY 



/ST/ 








JSTl 











1 



L 







Flowcharts 343 



Chart KE. DIDOCS status Display 2 (Part 2 of 2) 
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Chart KF. DIDOCS Status Display 3 (Part 1 of 2) 
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Chart KF. DIDOCS Status Display 3 (Part 2 of 2) 
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Chart KG. DIDOCS Status Display 4 
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Chart KH. DIDOCS Status Display 5 (Part 1 of 3) 




348 



Chart KH. DIDOCS Status Display 5 (Part 2 of 3) 
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Chart KH. DIDOCS Status Display 5 (Part 3 of 3) 
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Chart KI. DIDOCS Status Display 6 (Part 1 of 2) 
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Chart KI. DIDOCS Status Display 6 (Part 2 of 2) 
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Chart KJ. DIDOCS Status Display 7 
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Chart KK. DIDOCS Open/Close 
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Chart KL. DIDOCS PFK 1 (Part 1 of 2) 
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Chart KL. DIDOCS PFK 1 (Part 2 of 2) 
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Chart KM. DIDOCS PFK 2 
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Chart KN. DIDOCS Cleanup (Part 1 of 2) 
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Chart KN. DIDOCS Cleanup (Part 2 of 2) 
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Chart LA. Checkpoint Modules 
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Chart LB. Restart Modules 
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Chart MA. System Management Facility EXCP Counter (Part 1 of 2) 
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Chart MA., System Management Facility EXCP Counter (Part 2 of 2) 
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Chart MB. System Management Facility Time Limit Expiration 
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| IEAQEXOO | 




| Dispatcher 




| IEAODS | 




j SVC Type 1 Exit 




| IEA0XE00 | 


| IEAATAOO 


| SVC SLIH 




| IEAATAOO | 




j SVC EXIT (types 2, 3, 


4) 


| IEAAXT | 




j Validity Check 




| IEA0VL00 | 




j Task Switch Determination 


| TASKS WIT | 
JL_ j 


j *See also 


Task Supervision Figure 


46. 





Figure 45. Interruption Supervision 
Modules 



r i 

| Module 
| Name 


Routine Name 


-T 
I 


- — , 

Entry | 
Point j 


| IEAAIHOO* 


Stage 2 Exit Effector 


1 


IEA0EF00 | 




Stage 3 Exit Effector 




IEAEXTEF | 


| IEAAPTOO 


POST 




IGC002 | 


| IEAAPXOO 


SPIE 




IGC014 | 


| IEAASTOO 


STAE 




IGC00060 | 


| IEAAWTOO 


WAIT 




IGC001 | 


| IEAAXROO 


EXTRACT without subtasking 




IGC040 | 


| IEABXROO 


EXTRACT with subtasking 




IGC040 | 


| IEAGED02 


DETACH 




IGC062 | 


| IEAGENQ1 


ENQ/DEQ 




IGC048 | 
IGC056 j 


| IEAGENQ2 


ENQ/DEQ with Shared DASD 




IGC048 | 
IGC056 j 


| IEAQCB01 


Nonexecutable; contains 
address of first major QCB. 




IEAQCB01 | 


| IEAQATOO 


ATTACH with subtasking 




IGC042 | 


| IEAQCHOO 


CHAP 




IGC044 | 


| IEAQEFOO 
1- - J 


Stage 1 Exit Effector 


—X 


IGC043 | 


r 

| *See also 


Interruption Supervision Figure 


45 


| 



Figure 46. Task Supervision Modules 



| Module 

| Name 

L_ j 




Routine 


Name 


Entry | 
Point | 

L _ _J 


| IEAMADOO 


ABDUMP 


1 


1 


IGC0005A | 


| IEAAAD01 


ABDUMP 


4 




IGC0105A | 


| IEAAAD02 


ABDUMP 


5 




IGC0205A | 


| IEAAAD03 


ABDUMP 


6 




IGC0305A | 


| IEAAAD04 


ABDUMP 


8 




IGC0405A | 


| IEAAAD05 


ABDUMP 


9 




IGC0505A | 


| IEAAADOA 


ABDUMP 


3 




IGC0A05A | 


| IEAAADOB 


ABDUMP 


7 




IGC0B05A | 


| IEAAADOC 


ABDUMP 


11 




IGC0C05A | 


| IEAAADOD 


ABDUMP 


2 




IGC0D05A | 


| IEAAADOE 


ABDUMP 


10 




IGC0E05A | 


1 IEAAADOF 


ABDUMP 


12 




IGC0F05A | 


| IEAAADOK 


ABDUMP 


13 




IGC0K05A | 


| IEAAADOM 


ABDUMP 


14 




IGC0M05A | 


| IEAAADOY 


SVCDUMP 1 




IGC0005A | 


| IEAAADOZ 


SVCDUMP 2 




IGC0Z05A | 


| IEAASPRG 


Subsystem Purge 




IEAASPRG | 


| IEADTM22 


DAR 1 






IGC0221C | 


| IEADTM23 


DAR 2 






IGC0321C | 


| IEADTM24 


DAR 3 






IGC0421C | 


| IEADTM25 


DAR4 






IGC0521C | 


| IEAGABOO 


ABTERM 


without trace table 


IEA0AB00 | 


| IEAIABOO 


ABTERM 


with trace table 


IEA0AB00 | 


| IEANABOO 


ABTERM 


with subtasking 


IEA0AB00 | 


| IEANTMOO 


ABEND Normal Processor and 
Abnormal Router 


IGC0001C | 


| IEANTM01 


ABEND/ STAE Graphics Linkage 


IGC0101C | 


| IEANTM02 


ABEND 


I/O Purge 




IGC0201C | 


| IEANTM03 


ABEND 
Check 


Control Block Validity 


IGC0301C | 


| IEANTM04 


ABEND 


Dump Test 




IGC0401C | 


| IEAMTM05 


ABEND 


Open Dump Data Set 


IGC0501C | 


| IEANTM05 


ABEND Open Dump Data Set (with 
subtasking) 


IGC0501C | 


| IEANTM06 


ABEND 


Dump 




IGC0601C | 


| IEANTM07 


ABEND 


Termination 


IGC0701C | 


| IEANTM08 


ABEND 


Indicative 


Dump 


IGC0801C | 


| IEANTM09 


ABEND 


Recursion Processor 


IGC0901C | 


| IEANTMOA 


ABEND 


Steal Main 


Storage 


IGC0A01C | 


| IEACTMOB 


ABEND 


WTOR Purge 


(with MCS) 


I IGC0B01C | 



Figure 47. Task Termination Modules (Part 
1 of 2) 
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r i 
| Module 
1 Name 

L .j 


r ■ 
Routine Name 

L 


1 


1 

Entry | 
Point j 


| IEANTMOB 


r 

ABEND WTOR Purge (without MCS) 


1 


"1 

IGC0B01C j 


| IEANTMOC 


ABEND Loading Program Purge 
(with subtasking) 




IGC0C01C | 


| IEANTMOD 


ABEND Subtask Enqueue Purge 
(with subtasking) 




IGC0D01C | 


| IEANTM0E 


ABEND Data Set Close 




IGC0E01C | 


| IEANTMOF 


ABEND IQE Purge and Subtask 
Cleanup 




IGC0F01C | 


| IEANTMOG 


ABEND Abnormal Termination and 
ABEND Recursion 




IGC0G01C | 


| IEANTMOH 


ABEND WTO Recursion Messages 




IGC0H01C | 


| IEANTMOJ 


ABEND JPAQ and GQE Validity 
Check 




IGC0J01C | 


| IEANTMOM 


ABEND Message List Processor 




IGC0M01C | 


| IEASTM11 


ASIR Purge I/O 




IGC0111C | 


| IEASTM12 


ASIR Purge IOBs and Close DCBs 
(non-ISAM, non-TAM) 




IGC0211C | 


| IEASTM13 


ASIR Purge RB queue 




IGC0211C | 


| IEASTM14 
L 


ASIR Purge IOBs and Close DCBs 
(ISAM S TAM) 

L , 


1 


IGC0411C | 

j 


Figure 47 


Task Termination Modules (Part 
2 of 2) 


| Module 
J Name 

L _ _ J 


Routine Name 


"T 


Entry | 

Point j 

j 


| IEAAATOO 


Attach without subtasking 




IGC042 | 


J IEAAIDOO 


Identify 




IGC041 | 


j IEAATCOO 


Link 




IGC006 | 




XCTL 




IGC007 | 




Load 




IGC008 | 




FINCH 




IEA0FN00 | 




Transient Area Loading Task 




IEAFNCH | 


| IEAADLOO 

L J 


Delete 

L 


-J. 


IGC009 | 
J 



Figure 48. Contents Supervision Modules 



j Module 
j Name 

j IEAAMSOO 

I 
I 



Routine Name 



GETMAIN 
FREEMAIN 



Entry 
Point 



IGC004 
IGC005 



Figure 49. Main Storage Supervision 
Modules 



r - i 
| Module 
| Name 

I- — l 


r i 

Routine Name 

U - -J 


r — — i 
Entry | 
Point j 


r 1 
| IEECLCTX 


r 1 
Console Switch 1 (MCS) 


r - A 
IGCXL07B j 


| IEECMAWR 


Router (MCS) 


IEECMAWR | 


| IEECMCTR 


Mini-Router (MCS) 


IGC0007B | 


| IEECMCTX 


Console Switch 2 (MCS) 


IGCXM07B | 


j IEECMDOM 


Delete Operator Message 


IEECMDOM | 


j IEECMDSV 


Device Interface (MCS) 


IEECMDSV | 


| IEECMPMC 


2540 Processor (MCS) 


IGC1107B | 


| IEECMPMP 


1403/1443 Processor (MCS) 


IGC2107B | 


| IEECMPMX 


1052 Processor (MCS) 


IGC0107B | 


| IEECMPM1 


1052 Processor, Load 2 (MCS) 


IGC0207B | 


| IEECMWSV 


WTO Processor (MCS) 


IEECMWSV | 


| IEECMWTL 


NIP Message Buffer Writer 
(MCS) 


IGC0907B | 


| IEECNCTX 


Console Switch 3 (MCS) 


IGCXN07B | 


| IEECOCTX 


Console Switch 4 (MCS) 


IGCXO07B | 


| IEECVCRA 


I/O Attention Handler 


IEEBA1 | 


| IEECVCRX 


External Interruption Handler 


IEEBC1PE | 


| IEECVCTI 


Initialization 


IEECVCTI | 


| IEECVCTR 


Router (non-MCS) 


IGC0007B j 


| IEECVCTW 


Wait (non-MCS) 


IEECIR45 | 


| IEECVCTX 


Console Switch (non-MCS) 


IGCXL07B | 


| IEECVML1 


Multiple-line WTO (non-MCS) 
Load 1 


IEECVML1 | 


| IEECVML2 


Multiple-line WTO (non-MCS) 
Load 2 


IEECVML2 | 


| IEECVML3 


Multiple-line WTO (MCS) Load 1 


IEECVML3 | 


| IEECVML4 


Multiple-line WTO (non-MCS) 
Load 3 


IEECVML4 | 


| IEECVML5 


Multiple-line WTO (MCS) Load 2 


IEECVML5 | 


| IEECVML6 


Multiple-line WTO (MCS) Load 3 


IEECVML6 | 


| IEECVOCC 


2540 Open/Close 


IGC1I07B | 


| IEECVOCP 


1403/1443 Open/Close 


IGC2I07B | 


| IEECVOCX 


1052 Open/Close 


IGC0I07B | 


| IEECVPMC 


2540 Processor (non-MCS) 


IGC1107B | 


| IEECVPMP 


1403/1443 Processor (non-MCS) 


IGC2107B | 


| IEECVPMX 


1052 Processor Load 1 
(non-MCS) 


IGC0107B | 


| IEECVPM1 


1052 Processor, Load 2 
(non-MCS) 


IGC0207B | 


| IEEC2740 


2740 Processor (MCS) 


IEEC2740 | 


| IEENFWTO 


WTO Non-MCS 


IGC0003E | 


| IEENFWTO 


WTO MCS 


IGC0003E | 


| IEEVWTOR 


WTOR Service 


IGC0103E | 



Figure 50. Communications Task Modules 
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Module 

Name 

IEA0RT00 


-+ 


Routine 

Time 


Name 


+ . 


Entry 
Point 

IGCOll 


IEA0ST00 




TTIMER 
STIMER 






IGC046 
IGC047 


IEAOTIOx* 




Timer SLIH 
Timer Enqueue 
Timer Dequeue 






IEA0TI02 
IEAQTEOO 
IEAQTDOO 



-H 



j. ± ± ^ 

| *Module name is option dependent. See Figure 39. | 



Figure 51. Timer Supervision Modules 



r 

J Module 
j Name 


_ T — - 

| Routine Name 




T 

| Entry 
| Point 


(■ — ~ ~ 

| IEWSVOVR 


t 

| Resident Overlay 




| IGC037 


| IEWSYOVR 


| Nonresident Overlay 




| IEWSZOVR 


| IEWSXOVR 


| Nonresident Overlay with 
| Checking 


SEGWT 


| IEWSZOVR 



H 



Figure 52. Overlay Supervision Modules 



Module 
Name 



IGC0006C 
IGC0106C 
IGC0206C 
IGC0506C 
IGC0A06C 
IGC0D06C 
IGC0F06C 
IGC0N06C 
IGC0Q06C 
IGC0S06C 
IGC0L05B 

IGC0N05B 

IGC0Q05B 

IGC0105B 
IGC0205B 
IGC0505B 
IGC0605B 
IGC0G05B 
IGC0G95B 
IGC0H05B 
IGC0I05B 
IGC0J05B 
IGC0K05B 
IGC0M05B 
IGC0P05B 
IGC0R05B 
IGC0S05B 
IGC0T05B 
IGC0U05B 
IGC0V05B 
IGC0W05B 



Routine Name 



Housekeeping 1 | IGC0006C 

Housekeeping 2 | IGC0106C 

Housekeeping 3 | IGC0206C 

Check I/O | IGC0506C 

Preserve 1 | IGC0A06C 

Preserve 2 | IGC0D06C 

Checkmain | IGC0F06C 

Resume I/O | IGC0N06C 

Exit | IGC0Q06C 

Message | IGC0S06C 

SYSIN/SYSOUT Nondirect Access | IGC0L05B 

Processor j 

SYSIN/SYSOUT Direct Access | IGC0N05B 

Positioning 1 j 

SYSIN/SYSOUT Direct Access | IGC0Q05B 

Positioning 2 | 

Housekeeping 1 | IGC0105B 

Housekeeping 2 | IGC0205B 

Repmain 1 | IGC0505B 

Repmain 2 | IGC0605B 

JFCB 1 | IGC0G05B 

Dummy Data Set Processor 1 j IGC0G95B 

Dummy Data Set Processor 2 | IGC0H05B 

JFCB 2 j IGC0I05B 

TCAM Data Set Processor | IGC0J05B 

Mount/Verify Nondirect Access | IGC0K05B 

Mount/Verify Direct Access | IGC0M05B 

Data Set Processor 1 | IGC0P05B 

Data Set Processor 2 . | IGC0R05B 

Data Set Processor 1A | IGC0S05B 

Final Processing j IGC0T05B 

Data Set Processor | IGC0U05B 

Exit | IGC0V05B 

ISAM/BDAM Data Set Processor IGC0W05B 



Entry 
Point 



Figure 53. Checkpoint/Restart Modules 
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r- i 
| Module 
| Name 


r - - - - - - 

Routine Name 


i 


■ - — i 

Entry | 
Point | 


L j 


L 






. j 


| IGC5A07B 


r 
Options 




i 


IEECVETA | 


| IGC5C07B 


Asynchronous Error 




IEECVETC | 


; IGC5D07B 


Message 1 






IEECVETD | 


| IGC5E07B 


Message 2 






IEECVETE | 


| IGC5F07B 


Light Pen/Cursor 




IEECVETF | 


| IGC5G07B 


Open/Close 






IEECVETG | 


| IGC5H07B 


Model 85 I/O 






IEECVETH | 


| IGC5J07B 


Roll Mode 






IEECVETJ | 


| IGC5K07B 


Timer Interpreter 




IEECVETK | 


| IGC5P07B 


2250 I/O 1 






IEECVETP | 


| IGC5Q07B 


2250 I/O 2 






IEECVETQ | 


| IGC5R07B 


2260 I/O 1 






IEECVETR | 


| IGC5Z07B 


Processor l f Load 2 




IEECVETZ | 


| IGC5107B 


Processor l r Load 1 




IEECVET1 | 


| IGC5207B 


Display 1 






IEECVET2 | 


| IGC5307B 


Display 2 






IEECVET3 | 


| IGC5407B 


Command 






IEECVET4 | 


| IGC5607B 


Delete 1 






IEECVET6 | 


| IGC5707B 


Delete 2 






IEECVET7 | 


| IGC5807B 


Delete 3 






IEECVET8 | 


| IGC5907B 


Delete 4 






IEECVET9 | 


| IGC6A07B 


PFK 1 






IEECVFTA | 


| IGC6B07B 


PFK 2 






IEECVFTB | 


| IGC6D07B 


Message 3 






IEECVFTD | 


| IGC6G07B 


Cleanup 






IEECVFTG | 


| IGC6L07B 


Status Display 


Interface 


1 


IEECVFTL | 


| IGC6M07B 


Status Display 


Interface 


2 


IEECVFTM | 


| IGC6N07B 


Status Display 


Interface 


3 


IEECVFTN | 


| IGC6O07B 


Status Display 


Interface 


4 


IEECVFTO | 


| IGC6P07B 


Status Display 


Interface 


5 


IEECVFTP | 


| IGC6Q07B 


Status Display 


Interface 


6 


IEECVFTQ | 


| IGC6R07B 


2260 I/O 2 






IEECVFTR | 


| IGC6T07B 


Status Display 


Interface 


7 


IEECVFTT | 


| IGC6Z07B 


Processor 0, Load 2 




IEECVFTZ | 


| IGC6107B 


Processor 0, Load 1 




IEECVFT1 | 


| IGC6207B 


Display 3 






IEECVFT2 | 



Figure 54. DIDOCS Modules 
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T T 

Module 
Name 



Entry 
Point 



IEAAPKOO 

IEAASCOO 

IEAASPRG 

IEAATAOO 

IEAAXT 

IEAEXTEF 

IEAFNCH 

IEAQCB01 

IEAQEXOO 
IEAQTDOO 
IEAQTEOO 
IEAXKALL 

IEAXKDXR 

IEAXPALL 
IEAXPDXR 

IEAXPSIM 

IEA0AB00 
IEAOABOO 
IEAOABOO 
IEAODS 
IEAOATOl 
IEA0AT02 
IEA0EF00 
IEAOFNOO 
IEA0TI02 
Figure 55. 



Name of Routine 



Program Check FLIH 

SVC FLIH 

Subsystem Purge 

SVC SLIH 

SVC EXIT (Types 2, 3, and 4) 

Stage 3 Exit Effector 

Transient Area Loading Task 

Nonexecutable; points to 
address of first QCB 

Timer/External FLIH 

Timer DEQ 

Timer ENQ 

Extended Precision Floating 
Point Simulator for System/360 
models 

Extended Precision Floating 
Point Simulator for System/360 
Models 85 r 195 and System/370 
models 

Extended Precision Floating 
Point Simulator for System/360 
models 

Extended Precision Floating 
Point Simulator for System/360 
Models 85 f 195 and System/370 
models 

Extended Precision Floating 
Point Simulator CPU 
Determination 

ABTERM without trace table 

ABTERM with trace table 

ABTERM with subtasking 

Dispatcher 

ATTACH without subtasking 

ATTACH without subtasking 

Stage 2 Exit Effector 

FINCH 

Timer SLIH 



IEAAIHOO 
IEAAIHOO 
IEAASPRG 
IEAATAOO 
IEAATAOO 
IEAAIHOO 
IEAATCOO 
IEAQCB01 

IEAAIHOO 
IEA0TI00 
IEA0TI00 
IEAXPALL 

IEAXPDXR 

IEAXPALL 
IEAXPDXR 

IEAXPSIM 

IEAGABOO 
IEAIABOO 
IEANABOO 
IEAAIHOO 
IEAAATOO 
IEAAATOO 
IEAAIHOO 
IEAATCOO 
IEA0TI02 



CSECT 



IEAAIHOO 

IEAAIHOO 

IEAASPRG 

IEAATAOO 

IEAATAOO 

IEAEXTEF 

IGC006 

IEAQCB01 

IEAAIHOO 
IEA0TI02 
IEA0TI02 
IEAXPALL 

IEAXPDXR 

IEAXPALL 
IEAXPDXR 

IEAXPSIM 

IEAOABOO 

IEAOABOO 

IEAOABOO 

IEAAIHOO 

IGC042 

IGC042 

IEAAIHOO 

IGC006 

IEA0TI02 



Chart 



AE 
AA 

AB 

AC 

BO 

ED 

(Fig. 
23) 

AD 

HB 

HB 



CY 

AF 

EA 

EA 

BN 
EC, ED 
HB,HH 



SVC 



42 
42 



Type 



2 
2 



Supervisor Module Cross Reference (Part 1 of 8) 
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Entry 
Point 

1 

IEA0VL00 


Name of Routine 


Validity Check 


| Module 
Name 

— 

| IEAATA00 


IEA0XE00 


SVC Exit (Type 1) 


IEAAIH00 


IEEBA1 


Communication Task I/O Atten- 
tion Handler 


IEECVCRA 


IEEBC1PE 


Communication Task External 


IEECVCRX 


IEECIR45 


Communication Task Wait 
(non-MCS) 


IEECVCTW 


IEECMAWR 


Communication Task Router (MCS) 


i IEECMAWR 


IEECMDOM 


Communication Task Delete 
Operator Message 


IEECMDOM 


IEECMDSV 


Communication Task Device 
Interface 


IEECMDSV 


IEECMPMl 


1052 Processor, Load 2 (MCS) 


IEECMPM1 


IEECMWSV 


Communication Task WTO 
Processor 


IEECMWSV 


IEECVCTI 


Communication Task 
Initialization 


IEECVCTI 


IEECVETA 


DIDOCS 


Options 


IGC5A07B 


IEECVETC 


DIDOCS 


Asynchronous Error 


IGC5C07B 


IEECVETD 


DIDOCS 


Message 1 


IGC5D07B 


IEECVETE 


DIDOCS 


Message 2 


IGC5E07B 


IEECVETF 


DIDOCS 


Light Pen/Cursor 


IGC5F07B 


IEECVETG 


DIDOCS 


Open/Close 


IGC5G07B 


IEECVETH 


DIDOCS 


Model 85 I/O 


IGC5H07B 


IEECVETJ 


DIDOCS 


Roll Mode 


IGC5J07B 


IEECVETK 


DIDOCS 


Timer Interpreter 


IGC5K07B 


IEECVETP 


DIDOCS 


2250 I/O 1 


IGC5P07B 


IEECVETQ 


DIDOCS 


2250 I/O 2 


IGC5Q07B 


IEECVETR 


DIDOCS 


2260 I/O 1 


IGC5R07B 


IEECVETZ 


DIDOCS 


Processor 1, Load 2 


IGC5Z07B 


IEECVET1 


DIDOCS 


Processor 1, Load 1 


IGC5107B 


IEECVET2 


DIDOCS 


Display 1 


IGC5207B 


IEECVET3 


DIDOCS 


Display 2 


IGC5307B 


IEECVET4 


DIDOCS 


Command Routine 


IGC5407B 



L X 



*T 1 


r t t 


| CSECT 
4 ^ 

j IEAATA00 


Chart | SVC | Type 
.-+ + 






| IEEBA1 


| GB | | 


| IEEBC1PE 


GB | | 


| IEECIR45 


1 GF 1 1 


| IEECMAWR 


GI | | 


| IEECMDOM 


GM | 87 j 3 


| IEECMDSV 


GK | | 


| IGC0207B 


GX | | 


| IEECMWSV 


GL | | 


| IEECVCTI 


GA | j 


| IEECVETA 


JP | | 


| IEECVETC 


KC | | 


| IEECVETD 


JH | | 


| IEECVETE 


JI | | 


| IEECVETF 


JU | | 


| IEECVETG | 


KK | | 


| IEECVETH i 


JG | | 


| IEECVETJ 


JN | | 


| IEECVETK 


JV | | 


| IEECVETP 


JC | | 


| IEECVETQ 


JD | | 


| IEECVETR 


JE | | 


| IEECVETZ 


JB | | 


| IEECVET1 


JA | | 


| IEECVET2 


JK | | 


| IEECVET3 


JL | | 


| IEECVET4 


JO | | 



— A- 



Figure 55. Supervisor Module Cross Reference (Part 2 of 8) 
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r 1 

| Entry 
| Point 


Name of Routine 




_ T -, 

| Module 
| Name 


r i 

CSECT 




Chart 




SVC 


"T 

1 Type 


1 H 

| IEECVET6 


|. 

DIDOCS Delete 1 




_ + H 

| IGC5607B 


h 1 

IEECVET6 


h H 





-+ 


| IEECVET7 


DIDOCS Delete 2 




| IGC5707B 


IEECVET7 


JR 






| IEECVET8 


DIDOCS Delete 3 




| IGC5807B 


IEECVET8 


JS 






| IEECVET9 


DIDOCD Delete 4 




| IGC5907B 


IEECVET9 


JT 






| IEECVFTA 


DIDOCS PFK 1 




| IGC6A07B 


IEECVFTA 


KL 






| IEECVFTB 


DIDOCS PFK 2 




| IGC6B07B 


IEECVFTB 


KM 






| IEECVFTD 


DIDOCS Message 3 




| IGC6D07B 


IEECVFTD 


| JJ 


72 


1 4 


| IEECVFTG 


Cleanup 




| IGC6G07B 


IEECVFTG 


KN 






| IEECVFTL 


Status Display Interface 


1 


| IGC6L07B 


IEECVFTL 


KD 






| IEECVFTM 


Status Display Interface 


2 


| IGC6M07B 


IEECVFTM 


l KE 






| IEECVFTN 


Status Display Interface 


3 


| IGC6N07B 


IEECVFTN 


KF 






| IEECVFTO 


Status Display Interface 


4 


| IGC6O07B 


IEECVFTO 


KG 






| IEECVFTP 


Status Display Interface 


5 


| IGC6P07B 


IEECVFTP 


KH 






| IEECVFTQ 


Status Display Interface 


6 


| IGC6Q07B 


IEECVFTQ 


KI 






| IEECVFTR 


2260 I/O 2 




| IGC6R07B 


IEECVFTR 


JF 


72 


1 4 


| IEECVFTT 


Status Display Interface 


7 


| IGC6T07B 


IEECVFTT 


KJ 






| IEECVFTZ 


Processor f Load 2 




| IGC6Z07B 


IEECVFTZ 


KB 






| IEECVFT1 


Processor r Load 1 




| IGC6107B 


IEECVFT1 


KA 






| IEECVFT2 


Display 3 




| IGC6207B 


IEECVFT2 


JM 






| IEECVGCI 


Graphic Console Initialization 


| IEECVGCI 


IEECVGCI 








| IEECVML1 


MLWTO (Non-MCS) Load 1 




| IEECVML1 


IEECVML1 




35 


1 4 


| IEECVML2 


MLWTO (Non-MCS Load 2 




| IEECVML2 


IEECVML2 




35 


1 4 


| IEECVML3 


MLWTO (MCS) Load 1 




| IEECVML3 


IEECVML3 




35 


1 * 


| IEECVML4 


MLWTO (Non-MCS) Load 3 




| IEECVML4 


IEECVML4 




35 


1 4 


| IEECVML5 


MLWTO (MCS) Load 2 




| IEECVML5 


IEECVML5 




35 


1 4 


| IEECVML6 


MLWTO (MCS) Load 3 




| IEECVML6 


IEECVML6 




35 


I 4 


| IEECVOCC 


Card Reader Open/Close 




| IEECVOCC 


IGC1I07B 








| IEECVOCP 


Printer Open/Close 




| IEECVOCP 


IGC2I07B 








| IEECVOCX 


1052 Open/Close 




| IEECVOCX 


IGC0I07B 


GQ 






1 IEECVPMC 


Card Reader Processor (MCS) 


| IEECMPMC 


IGC1107B 


GS 






| IEECVPMP 


Printer Processor (MCS) 




| IEECMPMP 


IGC2107B 









L X X X . L X X J 
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r i 
| Entry 


r i 


r — i 
Module 


r —i 


r i 


r - -i 


r 


| Point 


Name of Routine 


Name 


CSECT 


Chart 


SVC 


Type 


1- ^ 

J IEECVPMX 


h ^ 

| 1052 Processor, Load 1 (MCS) 


H 

IEECMPMX 


^ 

IGC0107B 


GP 








| IEECVPMC 


Card Reader Processor (non-MCS) 


IEECVPMC 


IGC1107B 


GR 






| IEECVPMP 


i Printer Processor (non-MCS) 


IEECVPMP 


IGC2107B 








| IEECVPMX 


1052 Processor, Load 1 
(non-MCS) 


IEECVPMX 


IGC0107B 


GO 






| IEECVPM1 


1052 Processor, Load 2 
(non-MCS) 


IEECVPM1 


IGC0207B 








| IEEC2740 


2740 Processor (MCS only) 


IEEC2740 


IEEC2740 


GT 






| IEWSZOVR 


Basic Nonresident Overlay 
Supervisor with SEGWT Checking 


IEWSXOVR 


IEWSZOVR 








| IEWSZOVR 


Basic Nonresident Overlay 
Supervisor 


IEWSYOVR 


IEWSZOVR 








| IGCXL07B 


Communication Task Console 
Switch Load 1 (MCS) 


IEECLCTX 


IGCXL07B 


GJ j 






| IGCXL07B 


Communication Task Console 
Switch (non-MCS) 


IEECVCTX 


IGCXL07B 


GH 






| IGCXM07B 


Communication Task Console 
Switch Load 2 (MCS) 


IEECMCTX j 


IGCXM07B 


GJ | 






| IGCXN07B 


Communication Task Console 
Switch Load 3 (MCS) 


IEECNCTX 


IGCXN07B 


GJ 






| IGCXO07B 


Communication Task Console 
Switch Load 4 (MCS) 


IEECOCTX 


IGCXO07B 


GJ j 






| IGC001 


WAIT Service 


IEAAWT00 


IGC001 


BF 






| IGC002 


POST Service 


IEAAPT00 


IGC002 


BG 


2 


1 


| IGC003 


EXIT (Types 2, 3, and 4 SVC) 


IEAATA00 


IEAATA00 


AC 


3 


1 


| IGC004 


GETMAIN 


IEAAMS 


IEAAMS 


FA 


4 


1 


| IGC005 


FREEMAIN 


IEAAMS 


IEAAMS 


FA 


5 


1 


| IGC006 


LINK 


IEAATC00 


IGC006 


EB 


6 


2 


| IGC007 


XCTL 


IEAATC00 


IGC006 


EB 


7 


2 


| IGC008 


LOAD 


IEAATC00 


IGC006 


| EB 


8 


2 


| IGC009 


DELETE 


IEAADL00 


IGC009 


| EF 


9 


2 


| IGC010 


GETMAIN/FREEMAIN (R-form) 


IEAAMS 


IGC006 


| FA 


10 


1 


| IGC011 


TIME 


IEA0RT00 


j IGC011 


| HA, HE 


| 11 


1 1 


| IGC012 


SYNCH 


IEA0SY00 


1 IGC012 




12 


1 2 


| IGC014 


SPIE 


IEAAPX00 


1 IGC014 


| BK 


14 


1 2 


| IGC037 


Resident Overlay Supervisor 


| IEWSVOVR 


| IGC037 


1 !A 


| 37 


1 2 



L X JL J. 
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372 



r 1 

| Entry 
| Point 

i- ^ 

j IGC040 


1 

Name of Routine 


EXTRACT (without subtasking) 


r 1 

Module 

Name 

H 

IEAAXR00 


- — _, 

CSECT 

1- 

IGC040 j 


r ~ ~i 

Chart 

h 

BD 


r - -i 
SVC 



40 


Type j 
1 

1 | 


| IGC040 


EXTRACT (with subtasking) 


IEABXR00 


IGC040 


BE 


40 


1 1 


| IGC041 


IDENTIFY 




IEAAID00 I 


IGC041 | 


EE 


41 


2 I 


| IGC042 


ATTACH (without subtasking) 


IEAAAT00 | 


IGC042 


EA 


42 


2 I 


| IGC042 


ATTACH (with subtasking) 


IE AQ AT 00 


IGC042 


BA 


42 


2 I 


| IGC043 


Stage 1 Exit Effector 


IEAQEF00 


IGC043 


BM 


43 


2 I 


| IGC044 


CHAP 




IEAQCH00 


IGC044 


BC 


44 


1 1 


| IGC046 


TTIMER 




IEA0ST00 


IGC047 


HC,HF 


46 


1 1 


| IGC047 


STIMER 




IEA0ST00 


IGC047 


HD,HG 


47 


2 I 


| IGC048 


DEQ 




IEAGENQ1 


IGC048 


BJ 


48 


2 I 


| IGC048 


DEQ (with shared DASD) 


IEAGENQ2 


IGC048 


BJ 


48 


2 1 


| IGC056 


ENQ 




IEAGENQ1 


IGC048 


BH 


56 


2 1 


| IGC056 


ENQ (with shared DASD) 


IEAGENQ2 


IGC048 


BH 


56 


2 I 


| IGC062 


DETACH 




IEAGED02 


IGC062 


BB 


62 


2 I 


| IGC109 


Type 3 and 
Router 


4 ESR Extended SVC 


IGC116 


IGC116 


AI 


109 


2 | 


| IGC116 


Type 1 ESR 


Extended SVC Router 


IGC116 


IGC116 


AI 


116 


1 1 


| IGC117 


Type 2 ESR 


Extended SVC Router 


IGC116 


IGC116 


AI 


117 


2 I 


| IGC0A01C 


ABEND Load 


10 


IEANTMOA 


IGC0A01C 


CJ 


13 


4 1 


| IGC0A05A 


ABDUMP 3 




IEAAADOA 


IGC0A05A 


DD 






| IGC0A06C 


Checkpoint 


Preserve 1 


IGC0A06A 


IGC0A06A 


LA 


63 


4 1 


| IGC0B01C 


ABEND Load 


11 (non-MCS) 


IEACTMOB 


IGC0B01C 




13 


4 1 


| IGC0B01C 


ABEND Load 


11 (MCS) 


IEANTMOB 


IGC0B01C 


CK 


13 


^ 1 


| IGC0B05A 


ABDUMP 7 




IEAAADOB 


IGC0B05A 


DG 






| IGC0C01C 


ABEND Load 


12 


IEANTMOC 


IGC0C01C 


i CK 


13 


4 | 


| IGC0C05A 


ABDUMP 11 




IEAAADOC 


IGC0C05A 


DH 






| IGCOD01C 


ABEND Load 


13 


IEANTMOD 


IGC0D01C 


CK 


i 13 


4 | 


| IGC0D05A 


ABDUMP 2 




IEAAD05A 


IGC0D05A 


DD 






| IGC0D06C 


Checkpoint 


Preserve 2 


IGC0D06C 


IGC0D06C 


i LA 


1 63 


1 4 1 


| IGCOEOIC 


ABEND Load 


14 


IEANTMOE 


IGCOEOIC 


! CL 


1 13 


1 ^ 1 


| IGC0E05A 


ABDUMP 10 




IEAAADOE 


IGC0E05A 


| DH 






| IGCOFOIC 


ABEND Load 


15 


IEANTMOF 


IGCOFOIC 


| CM 


1 13 


i 4 1 



L X X X X X X J 
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r 1 

| Entry 
| Point 
L . 


1 

Name of Routine 

; 


r 1 

Module 

Name 




1 

CSECT 


r~ ~i 

Chart 

j 


r 

SVC 


r — • 

Type 


r 

| IGC0F05A 


ABDUMP 12 


IEAAADOF 




IGC0F05A | 


1 

DI | 








| IGC0F06C 




IGC0F06C 


IGC0F06C | 


LA | 


63 


4 


| IGC0G01C 


ABEND Load G 


IEANTMOG 


IGC0G01C ! 


CB | 


13 


4 


| IGC0G05B 


Restart JFCB 1 


IGC0G05B | 


IGC0G05B ! 


LB | 


52 


4 




ABEND Load H 


IEANTMOH | 


IGC0H01C | 


CO | 


13 


4 


| IGC0H05B 


Restart Dummy Data Set 
Processor 


IGC0H05B j 


IGC0H05B | 


LB | 


52 


4 


| IGC0I05B 


Restart JFCB 2 


IGC0I05B 


IGC0I05B 


LB 


52 


4 


| IGC0I07B 


1052 Open/Close 


IEECVOCX 


IGC0I07B 


GQ 






| IGC0J01C 


ABEND Load J 


IEANTMOJ 


IGC0J01C 


CP 


13 


4 


| IGC0J05B 


Restart TCAM Data Set Processor 


IGC0J05B 


IGC0J05B 


LB 


52 


4 


| IGC0K05A 


ABDUMP 13 


IEAAADOK 


IGC0K05A 


DJ 






| IGC0K05B 


Restart Mount/Verify Nondirect 
Access 


IGC0K05B 


IGC0K05B 


LB 


52 


4 


| IGC0L05A 


ABDUMP 1 


IEAMAD00 


IGC0L05A 


DC | 






| IGC0L05B 


SYSIN/SYSOUT Nondirect Access 
Processor 


IGC0L0 5B 


IGC0L05B 


LB | 


52 


4 


| IGCOM01C 


ABEND Load M 


IEANTMOM 


IGC0M01C 


CN 


13 


4 


| IGC0M05A 


ABDUMP 14 


IEAAADOM 


IGC0M05A 


DK 






| IGC0M05B 


Mount/Verify Direct Access 


IGC0M05B 


IGC0M05B 


LB 


52 


4 


| IGC0N05B 


SYSIN/SYSOUT Direct Access 
Positioning 1 


IGC0N05B 


IGC0N05B 


LB 


5-2 


4 


| IGC0N06C 


Checkpoint Resume I/O 


IGC0N06C 


IGC0N06C 


LA I 


63 


4 


| IGC0P05B 


Nondirect Access Positioning 


IGC0P05B 


IGC0P05B 


LB 


52 


4 


| IGC0Q05B 


SYSIN/SYSOUT Direct Access 
Positioning 2 


IGC0Q05B 


IGC0Q05B 


LB 


52 


4 


| IGC0Q06C 


Checkpoint Exit 


IGC0Q06C 


IGC0Q06C 


LA 


63 


4 


| IGC0R05B 


Direct Access Positioning 


IGC0R05B 


IGC0R05B 


LB 


52 


4 


| IGC0S05B 


Data Set Processor 1A 


IGC0S05B 


IGC0S05B 


LB 


52 


i * 


| IGC0S06C 


| Checkpoint Message 


IGC0S06C 


| IGC0S06C 


| LA 


63 


4 


| IGC0T05B 


Restart Final Process 


IGC0T05B 


| IGC0T05B 


| LB 


52 


1 1 


| IGC0U05B 


Restart Data Set Processor 


IGC0U05B 


| IGC0U05B 


| LB 


1 52 


1 4 


| IGC0V05B 


Restart Exit 


| IGC0V05B 


| IGC0V05B 


| LB 


1 52 


1 * 
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r —i 
| Entry 
| Point 

1 H 

| IGC0W05B 


r - — 

Name of Routine 
h 

Restart ISAM/BSAM Data Set 
Processor 


"T 1 

| Module 
| Name 

-+ H 

J IGC0W05B 




CSECT 

h H 

IGC0W05B 


, 

Chart 
r H 

LB 


r 1 

SVC 

h ^ 

52 


r 

Type 

h 

4 


| IGC0Z05A 


SVC DUMP 2 






| IEAAADOZ | 


IGC0Z05A | 


DB | 






| IGC0001C 


ABEND Load 






| IEANTM00 


IGC0001C 


CA 


13 


4 


| IGC0003E 


WTO MCS 






| IEEMFWTO 


IGC0003E 


GC 


35 


4 


| IGC0003E 


WTO Non-MCS 






| IEENFWTO | 


IGC0003E 


GC 


35 


4 


| IGC0005A 


SVC DUMP 1 






| IEAAADOY ! 


IGC0005A ! 


DA 






| IGC00060 


STAE 






| IEAAST00 


IGC00060 


BL 


60 


3 


| IGC0006C 


Checkpoint Housekeeping 


1 


| IGC0006C 


IGC0006C 


LA 


63 


4 


| IGC0007B 


Communication ' 
(MCS) 


rask Mini- 


-Router 


| IEECMCTR 


IGC0007B 




72 


4 


| IGC0007B 


Communication 
(non-MCS) 


rask Router 


| IEECVCTR 


IGC0007B 


GG 


72 


4 


| IGC0101C 


ABEND Load 1 






| IEANTM01 


IGC0101C 


CC 


13 


4 


| IGC0103E 


Communication ' 


rask WTOR 


Service 


| IEEVWTOR 


IGC0103E 


GE 






| IGC0105A 


ABDUMP 4 






| IEAAAD01 


IGC0105A 


DE 






| IGC0105B 


Restart Housekeeping 1 




| IGC0105B 


IGC0105B 


LB 


52 


4 


| IGC0106C 


Checkpoint Housekeeping 


2 


| IGC0106C 


IGC0106C 


LA 


63 


4 


| IGC0107B 


1052 Processor 


Load 1 (MCS) 


| IEECMPMX 


IGC0107B 


GP 






| IGC0107B 


1052 Processor 


Load 1 (non-MCS) 


| IEECVPMX 


IGC0107B 


GO 






| IGC0111C 


ASIR 1 






| IEASTM11 


IGC0111C 


CQ 




4 


| IGC0201C 


ABEND Load 2 






| IEANTM02 1 


IGC0201C 


CD 


13 


4 


| IGC0205A 


ABDUMP 5 






| IEAAAD02 


IGC0205A 


DF 






| IGC0205B 


Restart Housekeeping 2 




| IGC0205B 


IGC0205B 


LB 






| IGC0206C 


Checkpoint Housekeeping 


3 


| IGC0206C 


IGC0206C 


LA 


63 


4 


| IGC0207B 


1052 Processor 


Load 2 




| IEECMPM1 


IGC0207B 


GX 






| IGC0211C 


ASIR 2 






| IEASTM12 | 


IGC0211C 


CR 




4 


| IGC0221C 


DAR 1 






| IEADTM22 


IGC0221C 


CU 






| IGC0301C 


ABEND Load 3 






| IEANTM03 1 


IGC0301C 


CD 


13 


4 


| IGC0305A 


ABDUMP 6 






| IEAAAD03 j 


IGC0305A 


DF 






| IGC0311C 


ASIR 3 






| IEASTM13 j 


IGC0311C 


CS 




4 


| IGC0321C 


DAR 2 






| IEADTM23 | 


IGC0321C 


CV 






| IGC0401C 


ABEND Load 4 






| IEANTM04 | 


IGC0401C 


CE 


13 


4 



L J. X X J. X X J 
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Name of Routine 
.| 

ABDUMP 8 


r 1 

Module 

Name 

^ 

IEAAAD04 




CSECT 


IGC0405A 


1 

Chart 

h 

DG 


1 

SVC 

^ 


" 1 

Type | 
1 


IGC0411C 














IGC0421C 


DAR 3 


IEADTM24 


IGC0421C 


CW 






IGC0501C 


ABEND Load 5 (without 
subtasking) 


IEAMTM05 


IGC0501C 




13 


1 ** 1 


IGC0501C 


ABEND Load 5 (with subtasking) 


IEANTM05 | 


IGC0501C 


CF 


13 


4 | 


IGC0505A 


ABDUMP 9 


IEAAAD05 j 


IGC0505A 


DH 






IGC0505B 


Repmain 1 


IGC0505B 


IGC0505B 


LB 


52 


4 1 


IGC0506C 


Checkpoint I/O 


IGC0506C 


IGC0506C 


LA 


63 


4 | 


IGC0521C 


DAR 4 


IEANTM25 


IGC0521C 


CX 






IGC0601C 


ABEND Load 6 


IEANTM06 


IGC0601C 


CG 


13 


^ 1 


IGC0605B 


Repmain 2 


IGC0605B 


IGC0605B 


LB 


52 


4 1 


IGC0701C 


ABEND Load 7 


IEANTM07 


IGC0701C 


CH 


13 


! 4 1 


IGC0801C 


ABEND Load 8 


IEANTM08 j 


IGC0801C 


CH 


13 


1 4 1 


IGC0901C 


ABEND Load 9 


IEANTM09 | 


IGC0901C 


CI 


13 


1 4 1 


IGC0907B 


Communication Task NIP Message 
Buffer Writer (MCS) 


IEECMWTL ! 


IGC0907B 


GN 






IGC1I07B 


2540 Open/Close 


IEECVOCC 


IGC1I07B 




72 


1 4 1 


IGC1107B 


2540 Processor (MCS) 


IEECMPMC 


IGC1107B 


GS 


72 


1 4 1 


IGC1107B 


2540 Processor (non-MCS) 


IEECVPMC 


IGC1107B 


GR 


72 


1 4 1 


IGC2I07B 


Printer Open/Close 


IEECVOCP 


IGC2I07B 




72 


1 4 1 


IGC2107B 


Printer Processor (MCS) 


IEECMPMP 


IGC2107B 




72 


1 4 1 


IGC2107B 


Printer Processor (non-MCS) 


IEECVPMP 


IGC2107B 




72 


1 4 1 


SVE 


SVC SLIH 


IEAATA00 


IEAATA00 


| AB 






TASKSWIT 


Task Switch Determination 


IEAATA00 


IEAATA00 


| AB 






XFINCH 




FINCH 

L J 


IEAATC00 

L J 
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SECTION 5: DATA AREAS 



This section describes the format and contents of the control blocks , parameter lists, 
and other data areas used in MFT. The offsets of particular bytes from the first byte 
(byte 0) are given in decimal, with the hexadecimal displacement in parentheses. 



ABDUMP PARAMETER LIST 



Offset 

(0) 

1 (1) 

2 (2) 



(3) 



5 (5) 

8 (8) 

9 (9) 

12 (C) 

13 (D) 



Bytes and 
Bit Pattern 



1 
2 



First Byte 



Field 
Name 




Second Byte 

1-.. 

.0.. 

.1.. 

..1. 

• •.1 






PFABEND 

PFTCB 

PFSUPDAT 

PFTRACE 

PFNUC 

PFSNAP 

PFID 

PFQCB 



PFSAVE 
PFSAVE2 

PFREGS 
PFLPA 

PFJPA 

PFPSW 
PFSPAIL 



1 
3 

1 

3 

1 
3 



Field Description 
Identification number. 

Reserved. 

Option Flags. 



Requested by ABEND. 

Requested by SNAP. 

TCB address is given. 

Display all supervisor data. 

Display trace table (if possible). 

Display the nucleus. 

Snapshot list is given. 

ID is given. 

Reserved. 



Save area (see next flag). 

Display entire save area. 

Display headings only. 

Display registers on entry to ABEND or SNAP. 

Display modules in the resident reenterable module 

area used by the task being dumped. 

Display all main storage assigned to the job step 

task. 

Display PSW on entry to ABEND or SNAP. 

Display all main storage assigned to the job step 

task. 

Reserved. 

Reserved. 

Address of DCB. 



SNAP request. 
SDUMP request. 

Address of TCB. 

Reserved. 

Address of storage list. 
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Bytes 


and 


Field 


Offset 


Bit 


Pattern 


Name 


-16 (-10) 


4 






QNXTREQ 


-12 (-C) 


4 






QSVRB 


-8 (-8) 


8 








(0) 


1 








1 (1) 


3 









BOUNDARY BOX 

SQA boundary box is in the master scheduler resident data area at offset X , 64 t . Par- 
tition boundary box is pointed to by TCBMSS field. 

Field Description 

Address of next QNXTREQ on Transient Area Request 

Queue when this task has a request pending. 

Address of SVRB for this transient area request. 

Reserved for ABEND appendages. 

Reserved for LCS flags. 

For job step task: address of hierarchy FQE for 
highest free area. For subtask: address of last GQE 
created for subtask. 

The following fields (offsets 4-23) exist only if the boundary box is for a job step 
task: 

4 (4) 4 Address of highest main storage address in hierarchy 

0. 

8(8) 4 Address of lowest main storage address in hierarchy 

0. 

The following fields are included only with Main Storage Hierarchy Support: 

12 (C) 4 Address of hierarchy 1 FQE for highest free area. 

16 (10) 4 Address of highest main storage address in hierarchy 

1. 

20 (14) 4 Address of lowest main storage address in hierarchy 

1. 
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CHECKPOINT HEADER RECORD (CHR) 



l<~ 



—8 bytes- 



->l 



dec hex 
4 



44 



4 r 



20 14 
28 1C 
36 24 



2C 



52 34 



r r - 

| Number of | 
| CHKPTs | 
I I 

__X X- 



CHECKIS 
Length 



CHECKID (left justified) 
(Checkpoint Entry Identification) 



DDNAME of CHECKPOINT Data Set 



Lower Boundary of Problem 
Program Storage 



T- 



CHKPT 
Blocksize 



TIOT 
Length 



Upper Boundary of Problem 
Program Storage 
x 



CHECKPOINT Work Area 
Address 



Lower Boundary of IBM 2361 
Core Storage 



CHECKPOINT Work Area Size 



CHECKPOINT SVRB Address 



-I 



Upper Boundary of IBM 2361 
Core Storage 



Note ; The CHR is 400 bytes long and is padded with ones. 



CORE IMAGE RECORD (CIR) 



^ 

Problem Program Core 
_ Hi 



I 

I 

V 
Direct copy of problem program storage, 
from the highest to the lowest address. 

Blocksize 1. Is specified by the caller, or 

2. If not specif ied f is the 

maximum for the device type. 
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COMMUNICATION VECTOR TABLE 



Pointed to by main storage location 
Offset 



16. 



Bytes and Field 
Bit Pattern Name 



-6 -(6) 

-4 (-4) 

(0) 



4 


(4) 


4 


8 


(8) 


4 


12 


(C) 


4 


16 


(10) 


4 


20 


(14) 


4 


24 


(18) 


4 


28 


(lc) 


4 


32 


(20) 


4 


36 


(24) 


4 


40 


(28) 


4 


44 


(2c) 


4 


48 


(30) 


4 


52 


(34) 


4 


56 


(38) 


4 


60 


(3C) 


4 



Field Description 
CVTMDL The model number of the CPU in decimal. Each digit 
is represented by four bits; the significant digits 
are right justified within the halfword. 

CVTRELNO Release number in EBCDIC. 

CVTTCBP Address of a doubleword field (IEATCBP) within the 

Dispatcher , the first containing the next-to-be dis- 
patched TCB address, the second containing the last- 
to- be- dispatched (current) TCB address. During task 
execution, both words are identical. When in a wait 
state , the first word is set to until the waiting 
is over; then both words are once again identical. 
During task switching , the words may not be 
identical. 

CVT0EF00 Address of Stage 2 Exit Effector. 

CVTLINK Address of the DCB for the SYS1.LINKLIB data set. 

CVTJOB Address of work queue control blocks used by the job 
scheduler. 

CVTBUF Address of the buffer of the resident console inter- 
ruption routine. 

CVTXAPG Address of the I/O supervisor appendage table. 

CVT0VL00 Address of entry point of the task supervisor* s 
address validity check routine. 

CVTPCNVT Entry point of the routine which converts a relative 
track address (TTR) to an absolute track address 
(MBBCCHHR) . 

CVTPRLTV Entry point of the routine that converts an absolute 
track address (MBBCCHHR) to a relative track address 
(TTR). 

CVTILK1 Address of the channel and control unit portion of 
the UCB lookup table. 

CVTILK2 Address of the UCB address-list portion of the UCB 
lookup table. 

CVTXTLER Entry point of an XCTL routine that brings system 
error routines into the error transient area. 

CVTSYSAD Address of the system residence volume entry in the 
UCB table. 

CVTBTERM Entry point of the ABTERM routine. 

CVTDATE Current date in packed decimal. 

CVTMSLT Address of master scheduler resident linkage table. 

Note : The master scheduler resident data area con- 
sists of a data area followed by the master common 
area. The master common area is currently at the 
same offset (136 decimal, X^S") from the beginning 
of both the master resident core and the master 
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Offset 
60 (3C) 
(cont. ) 



Bytes and 
Bit Pattern 



Field 
Name 



64 (40) 4 
68 (44) 4 
72 (48) 4 



76 


(4C) 


4 


80 


(50) 


2 


82 


(52) 


2 


84 


(54) 


4 


88 


(58) 


4 



92 (5C) 4 
96 (60) 4 
100 (64) 4 



104 (68) 

108 (6C) 

112 (70) 

116 (74) 



0001 0000 
0001 0100 
0010 0000 
0100 0000 



117 (75) 3 

120 (78) 4 

124 (7C) 4 

128 (80) 4 



CVTZDTAB 

CVTXITP 

CVTDAR 

CVT0FN00 

CVTEXIT 

CVTBRET 

CVTSVDCB 
CVTTPC 

CVTPBLDL 

CVTSJQ 

CVTCUCB 

CVTQTE00 

CVTQTDOO 

CVTSTB 

CVTDCB 

CVT4MS1 

CVT4MPS 

CVT2SPS 

CVT1SSS 

CVTDCBA 

CVTIOQET 
CVTIXAVL 

CVTNUCB 



132 (84) 4 
136 (88) 4 



CVTFBOSV 
CVTODS 



Field Description 

scheduler resident data area, but its offset from the 
beginning of the master scheduler resident data area 
may change in future releases. Therefore, all 
references to the master common area should be made 
using the address in CVTMSLT, and all references to 
the data area of the master scheduler resident data 
area should be made using the address in CVTMSER, at 
offset 148 (X'94'K 

Address of the I/O device characteristic table. 

Address of the error interpreter routine. 

Address of the I/O control block complex needed by 
ABEND'S Damage Assessment Routine (DAR) . If zeros, 
SYS1.DUMP data set has not been defined. 

Entry point of the FINCH routine. 

An SVC 3 instruction (EXIT). 

A BR 14 instruction (used by data management 
routines) . 

Address of the DCB for the SYS1.SVCLIB data set. 

Address of the 6 -hour pseudo clock (SHPC) , used by 
timer supervisor routines. 

Address of BAL entry point to the BLDL routine. 

Address of the selected job queue. 

Address of the table that contains the current con- 
sole's UCB addresses (Unit control Module). 

Address of the timer enqueue routine. 

Address of the timer dequeue routine. 

Address of the I/O device statistics table. 

System Configuration. 
MVT - Uniprocessing 
MVT - Multiprocessing 
MFT 
PCP 

Address of the DCB for the SYS1.L0GREC (outboard 
recorder) data set for system environment recording. 

Address of request element table. 

Address of the I/O supervisor's freelist pointer 
(which contains the address of the next request 
element) . 

Lowest address not in the nucleus. If the protection 
option is specified in the system generation process, 
this is a 2K boundary. 

If the protection option is not specified in the sys- 
tem generation process, this is a doubleword 
boundary . 

Address of program fetch routine. 

Address of entry point of the Dispatcher. 
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Offset 
140 (8C) 


Bytes and 
Bit Pattern 
4 


Field 

Name 

CVTILCH 


144 (90) 


4 






CVTIERLC 


148 (94) 


4 






CVTMSER 



152 (98) 4 

156 (9C) 4 

160 (A0) 4 

164 (A4) 4 

168 (A8) 4 

172 (AC) 4 

176 (BO) 4 

180 (B4) 2 



CVT0PT01 
CVTTRMTB 

CVTHEAD 

CVTMZOO 

CVT1EF00 
CVTQOCR 

CVTQMWR 
CVTSNCTR 



Field Description 

Address of the logical channel word table. 

Address of the asynchronous exit queue. 

Address of master scheduler resident data area. 

Note : This field should be used to address the data 
area, but not the master common area, of the master 
scheduler resident data area. See the note under 
CVTMSLT, at offset 60 (X f 3C'). 

Address of branch entry point of POST routine. 

Address of terminal table present in systems that 
have QTAM routines. 

Address of the highest priority TCB in the queue of 
TCBs for executing tasks. 

Highest storage address for this machine (machine 
size) . 

Reserved. 

Graphics interface task (GFX) field. If GFX is 
active: address of seventh word of GFX parameter 
list. If GFX is not active: (Four bytes of binary 
f s). 

Address of system output communications- data-area 
(CDA) which is stored on an external device used by 
the queue manager. 

Serial number counter. Counter for assigning serial 
numbers to nonspecific, unlabeled magnetic tape 
volumes. (A binary number forming the XXX part of 
the volume serial number of the form LXXXYY.) 



182 


(B6) 


1 




CVTOPTA 






1... 





CVTCCH 






.1.. 




CVTAPR 






..1. 


• • ■ • 


CVTDDR 






...1 


• • • • 


CVTNIP 






• • • • 


1... 


CVTATTCH 






• • • • 


.1.. 


CVTHIAR 








..1. 
...1 


CVT ASCII 
CVTXPFP 


183 


(B7) 


1 
1... 




CVTOPTB 
CVTPROT 






..1. 


• • • • 


CVTTOD 



184 (B8) 4 

188 (BC) 4 

192 (CO) 4 

196 (C4) 4 



CVTQCDSR 



CVTQLPAQ 



CVTSMCA 



Channel Check Handler (CCH) option is present in 

the system. 

Automatic Path Retry selected. 

Dynamic Device Reconfiguration selected. 

NIP is executing. 

Subtasking option (ATTACH) selected. 

Main Storage Hierarchy Support operative. 

ASCII option selected. 

Extended Precision Floating Point selected. 



Store Protection selected. 
CPU has Time-of-Day Clock. 

Without Link Library Option: Reserved. 

With Link Library Option: Address of the reenterable 

load module queue search routine. 

Without Link Library Option: Reserved. 

With Link Library Option: Address of Reenterable 

Load Module Queue. 

Reserved. 

Address of the System Management Control Area if the 
System Management Facilities option is present in the 
system. 
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Offset 
200 (C8) 


Bytes and 
Bit Pattern 
4 


Field 
Name 


204 


(CO 


4 






CVTUSER 


208 


(DO) 


4 






CVTMDLDS 


212 


(D4) 


2 






CVTQABST 


214 


(D6) 


2 






CVTLNKSC 


216 


(D8) 


4 






CVTTSCE 


220 


(DC) 


4 






CVTPATCH 


224 


(E0) 


4 






CVTRMS 



Bytes 228 through 231 are reserved. 
232 (E8) 4 CVT0SCR1 



236 


(EC) 


4 




CVTGTF 


236 


(EC) 


First Byte 


CVTGTFST 






00.. 


• • • • 


CVTGTFS 






01.. 


• • • • 








10.. 


• • • • 








11.. 


• • • • 








..1. 


• • • • 


CVTSTATE 






...0 





CVTMODE 






...1 


.... 











1... 


CVTFORM 









0. .. 








.... 


.1.. 
..1. 




237 


(ED) 


3 




CVTCMT 


240 


(F0) 


1 




CVTTCMFG 






1... 


.... 


CVTTCRDY 






0... 






241 


(Fl) 


3 




CVTAQAVT 


244 


(F4) 


1 




CVTTSKS 


245 


(F5) 


3 




CVTTAT 



248 (F8) 1 CVTSYST 

Bytes 249 through 259 are reserved. 
260 (104) 4 CVTPURG 

268 CVTQMSGA 



Field Description 
Reserved. 

A field available to the user of System/360 Operating 
System. 

Reserved. 

An SVC 13 instruction (ABEND). 

An SVC 6 instruction (LINK) . 

Address of the time-slice control element (TSCE) . 

Address of 200-byte patch area in nucleus. 

Address of machine status block for RMS. 



Address of the sector calculation routine for rota- 
tional position sensing (RPS) . 

Status flags and the address of the Class Mask Table 
for the Generalized Trace Facility (GTF) . 

Status flags for GTF. 

GTF not active. 

GTF starting. 

GTF stopping. 

GTF active. 

GTF is in control. 

Trace data is to be written in main storage (MODE=INT 

specified) . 

Trace data is to be written to auxiliary storage 

(MODE=EXT specified) . 

Trace data is to be formatted on abnormal 

termination . 

ABDUMP is to bypass formatting of trace data. 

CVTUSR - User requested trace data is to be included 

in the trace data set. 

CVTMCTYP - The System/370 MONITOR CALL instruction is 

valid. 

Address of the Class Mask Table (CMT) . 

TCAM flags. 

TCAM is ready to accept users. 

TCAM is not ready or has abnormally terminated. 

Address of first word of TCAM dispatcher. This word 
contains the address of the AVT. 

The maximum allowable number of entries in the TCB 
address table. 

Address of the first entry in the TCB address table. 
The first entry is for Partition . 

The number of entries in the TCB address table f for 
TCBs created during system generation. 



Address of the Subsystem Purge routine. 

Address of Message Information List module 
(IEAQMSGS) . 
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DATA SET DESCRIPTOR RECORDS 



Type 1 DSDR 
2 



178 



186 



190 



I 

I 

I 
-X- 



I I 

|X f 0000" [ 

I I 

L ^ JL- 



JFCB 



DDNAME 



UCBTYP 



Type 1 DSDR 

Identifier 

(2 bytes) 

Type 2 DSDR 



I I 

ix'oooa* | 
I I 

L JL_ 



I 
I 

t 

Job File 

Control Block 

(176 bytes) 



JFCB Extension 



178 



DDNAME of the 

CHECKPOINT Data Set 

(8 bytes) 



Unit Control Block 
Type, Field 
(4 bytes) 



Type 2 DSDR 


Job File Control 




Identifier 


Block Extension 




(2 bytes) 


(176 bytes) 




Type 3 DSDR 






2 




178 


r - - — |- — 

| | 




T 

I 


|X"0008 a | 
i i 


GDG BCT 


1 

1 

1 


1 1 

L i 


— —————— ——T——— ——- 


1 
J 



Type 3 DSDR 

Identifier 

(2 bytes) 



Generation Data Group 
Bias Count Table 
(176 bytes) 



Special Identifiers 

2 

r 1 

| | Indicates that the 

| X" 0010' | -►previous DSDR is the 
| J last one. 

L J 







2 



Indicates that the 
JX , 0014' (-^-previous DSDR is the 
I | last one in the block. 

L J 
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RESIDENT DISPLAY CONTROL MODULE (RDCM) 
Pointed to by field UCMXB in UCM entry. 



Offset 
(0) 



(4) 



(5) 



16 (10) 



20 
21 



(14) 
(15) 



24 (18) 



Bytes and 
Bit Pattern 



1.. 
1. 



1. . 

.1 . 
.. 1 



6 


(6) 


2 


8 


(8) 


4 


12 


(C) 


1 


13 


(D) 


1 


14 


(E) 


1 
1 


15 


(F) 


1 
1 



28 


(1C) 


2 


30 


(IE) 


2 


32 


(20) 


4 


36 


(24) 


4 


40 


(28) 


2 


42 


(2A) 


2 


44 


(2C) 


1 

1... • 
• x • • • 



Field 

Name 

DCMADTRN 



DCMFNDEX 



DCMRFLGS 



DCMLEN 

DCMADKP 

DCMTOPAR 

DCMTOPDS 

DCMRESTA 

DCMDEVTY 

DCMADSDS 

DCMRMS 
DCMADRMS 

DCMWLAST 

DCMRMSAL 

DCMMSGSV 
DCMADPFK 

DCMINTVL 
DCMTMCTR 
DCMR2FLG 



Field Description 

Address of the main storage area assigned to the 

TDCM. 

Display console identification number assigned by the 
graphic console unit. 

Contains flags indicating the status of the display 

console as follows: 

DCM read in process. 

Console uses transient DCMs. 

DCM write in process. 

DOM must be tries. 

DCM was used by NIP. 

First read of DCM. 

Processor routing flag. 

Length of the transient portion of the DCM. 

Address of the routed K command parameter list. 

Area ID of the topmost display area defined for the 
screen. 

Area ID of the topmost display area that is in use 
(contains a display) . 

Attention and open flags: 
Attention status has been saved 
Open status has been saved 

Device type flags: 

2260 

2250 

Pointer to the first screen area control block (this 
field contains zeros if no display areas are defined 
for the screen) . 

Recovery management system (RMS) information. 

Address of recovery management system (RMS) channel 
programs . 

Address of the last console queue entry to be 
displayed. 

Number of lines in the message area. 

Reserved. 

Address of a list of saved NIP messages. 

Address of the resident program function keyboard 
(PFK) area. 

Time interval for the DCM. 

Time counter for the DCM. 

Information flags conceiving the timer: 

Full screen 

Unviewable message displayed 
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Offset 
44 (2D) 
(cont.) 



45 (2D) 



Bytes and 
Bit Pattern 

1 ... 
. 1.. 
. .1. 
. ..1 



1 



Field 

Name 



DCMR3FLG 



Field Description 

Timer flag 

Ready to roll 

Pending delete request 

Entry was from options 

Timer elapsed 

TDCM is in core 



Changing status of output-only console 

Entry for K VARY 

Close in process 

Asynchronous error message on screen 



Screen Area Control Block (SACB) 

The following fields comprise the screen area control block (SACB) portion of the 
RDCM. One complete screen area control block is created for each display area defined 
for the screen; if no display areas are defined, no screen control blocks are created. 
SACBs may be contiguous with the RDCM or may be chained to the RDCM by pointers. 



Field Description 

Length of the display area in bytes. 

Length of the screen area control block prefix in 
bytes. 

Address of the next screen area control block. 

Alphabetic identifier assigned to the display area. 

Screen area control block flags with the following 

meanings: 

SACB in use 

SACB space was obtained by GETMAIN 

Length of the display area in bytes. 

Line number of the top line of the display area. 

Line number of the line to be written next. 

Frame number of the frame being displayed. 

Address of the console queue entry for the major WQE. 

Address of the console queue entry for the minor WQE 
being written. 

Time indicator written in the control line of the 
display being written. 

Message type flags: 
MONITOR A 

Flags pertaining to the display area status: 

Display coming to area 

Display in area 

End of display on screen 

Framing in progress 

Frame full 

Blanking to be done 



Offset 
48 (30) 


Bytes and 
Bit Pattern 
2 


Field 

Name 

DCMPLN 


50 


(32) 


2 




DCMPLNPR 


52 


(34) 


4 




DCMACBNX 


56 


(38) 


1 




DCMAID 


57 


(39) 


1 

1... 
.1.. 





DCMASACB 


58 


(3A) 


2 




DCMALN 


60 


(3C) 


1 




DCMATOP 


61 


(3D) 


1 




DCMAROW 


62 


(3E) 


2 




DCMAFR 


64 


(40) 


4 




DCMAMJWQ 


68 


(44) 


4 




DCMAMIN 


72 


(48) 


4 




DCMATIME 


76 


(4C) 


2 
..1. 


.... 


DCMAMT 


78 


(4E) 


1 

1... 

.1.. 

..1. 

...1 


1... 
.1.. 


DCMAFLG1 



386 



Offset 
79 UF) 


Bytes and 

Bit Pattern 

1 

1. .. 


Field 

Name 

DCMAFLG2 




.1.. 
.-1. 
...1 






80 (50) 


1 




DCMADFLG 




1... 


.... 






.1.. 


.... 






..1. 


• • • • 





Field Description 

Flags pertaining to the display area status: 

Saved pointer to last minor output 

Write control line 

Rewrite control line 

Major WQE has been found 



Flags pertaining to the display in the display area: 

Dynamic display 

Dynamic display in hold mode 

Dynamic display with control line in SIB 



81 (51) 3 Reserved. 
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TRANSIENT DISPLAY CONTROL MODULE (TDCM) 
Pointed to by Resident DCM 

The TDCM contains two sections: the device-independent section and the device- 
dependent section. The names and displacements of all fields in the device-independent 
section are identical for all devices w but the contents of the fields may vary depending 
on device type. The device- dependent section varies according to the device it is 
supporting. 



Offset 
(0) 

2 (2) 


Bytes and 
Bit Pattern 
2 

2 


Field 
Name 
DCM 
length 


4 


(4) 


1 
...1 


..1. 


DCMFLGl 

DCMQUE 

DCMOUTPT 


5 


(5) 


3 






8 


(8) 


4 




DCMWTINT 


12 


(3) 


4 






16 


(10) 


4 




DCMPACK 


20 


(14) 


4 




DCMCVBIN 


24 


(18) 


1 

1... 

.1.. 

..1. 

...1 


1... 
.1.. 
..1. 

...1 


DCMTIMES 
DCMTIMER 
DCMOPTTI 
DCMGROLL 
DCMOTTMM 
DCMSTTMR 
DCMTASYN 
DCMOCTTI 
DCMRMTTI 


24 


(19) 


1 






26 


(1.A) 


2 




DCMELGN 


28 


(1C) 


4 




DCMBUFAD 


32 


(20) 


4 




DCMDOMPK 


36 


(24) 


4 




DCMAMTAB 


40 


(28) 


4 




DCMADSEC 


44 


(2C) 


4 




DCMADDRL 


48 


(30) 


4 




DCMASCRN 


52 


(34) 


4 




DCMLSCRN 


56 


(38) 


4 




DCMWTBUF 


60 


(3C) 


4 




DCMAINS 


64 


(40) 


4 




DCMAENTR 



Field Description 

Length of the TDCM in bytes. 

Reserved. 

Flags pertaining to the DCM. 
Queue this DCM for write. 
DCM updated for output-only. 

Reserved. 

DCMWTBUF initial value. 

Reserved. 

Area used for packing decimal digits. 

Area used for convert to binary. 

Timer routine flags. 

Timer elapsed for this display. 

Options to Timer-Interpreter. 

Display ready to roll. 

Options or T/I to message module. 

STIMER should be issued. 

Timer set for asynchronous error message. 

OPEN/CLOSE to T/I routine. 

Roll mode to T/I routine. 

Reserved. 

Entry area last character pointer. 

Address of the buffer address table. 

Address of the first DOM Number. 

Address of the first screen control table entry. 

Address of the first secondary screen control table 
entry. 

Address of the last screen control table entry. 

Address of the screen image buffer. 

Address of the last line of the screen image buffer. 

Address of the last line of the message area in the 
screen image buffer. 

Address of the insrruction line in the screen image 
buffer. 

Address of the entry area in the screen image buffer. 
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Offset 
68 (44) 


Bytes and 
Bit Pattern 
4 


Field 

Name 

DCMAWARN 


72 


(48) 


4 


DCMADCHP 


76 


(4C) 


4 


DCMPFKLN 


80 


(50) 


4 


DCMCXSVE 


84 


(54) 


4 


DCMADOPN 


88 


(58) 


20 


DCMDSAV 


108 


(6C) 


2 


DCMINLGN 


110 


(6E) 


2 


DCMMCSFL 


112 


(70) 


128 


DCMINPUT 


240 


(F0) 


8 


DCMRQDEL 


248 


(F8) 


2 


DCMLGNTH 


250 


(FA) 


2 


DCMBAINC 


252 


(FC) 


2 


DCMIRCTR 


254 


(FE) 


2 


DCMBADLN 


256 


(100) 


2 


DCMBYTCT 


258 


(102) 


2 


DCMADNUM 


260 


(104) 


2 


DCMAXLGN 


262 


(106) 


2 


DCMMSGAL 


264 


(108) 


2 


DCMRMINC 


266 


(10A) 


2 


DCMSCTCN 


268 


(IOC) 


2 


DCMCORLN 


270 


(10E) 


2 




272 


(110) 


1 


DCMPFKNM 


273 


(111) 


1 


DCMPFKKN 



274 (112) 2 

276 (114) 1 

277 (115) 1 

278 (116) 1 

279 (117) 1 



DCMDEL 



DCMCON 



DCMSEG 



DCMDL 



DCMRNUM 



Field Description 

Address of the warning line in the screen image 

buffer. 

Address of the channel program area. 

Reserved. 

CXSA save area. 

Address of the command operand. 

Command save area and work area. 

Input length. 

Space for PCS flags. 

Space for input message text. 

Buffer for pending delete requests. 

Length of a line. 

Position of cursor in screen image buffer. 

INTERVENTION REQUESTED message counter. 

Location in buffer to begin writing message. 

Number of bytes to write. 

The line number to be assigned to the next line. 

Maximum line length. 

Number of lines in the message area. 

RMI information. 

Length of one SCT entry. 

Length of DCM line in main storage. 

Reserved. 

Number of the PFK key being processed. 

Number of the PFK key, in a list of PFK keys, that is 
being processed. 

Contains the current value of the DEL parameter of 
the CONTROL S command (Y or N) . 

Contains the current value of the CON parameter of 
the CONTROL S command (Y or N) . 

Contains the current value of the SEG parameter of 
the CONTROL S command (numerical value). 

Contains the current value of the DL parameter of the 
CONTROL S command (numerical value) . 

Contains the current value of the RNUM parameter of 
the CONTROL S command (numerical value). 
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Offset 



Bytes and 
Bit Pattern 



280 (118) 2 



282 
283 
284 
286 
287 
288 
289 
290 
291 



292 

293 
294 



295 



296 



297 



(11A) 1 

(11B) 1 

(11C) 2 

(HE) 1 

(11F) 1 

(120) 1 

(121) 1 

(122) 1 

(123) 1 
1. 



(125) 






(12U) 1 
1. 



.1.. 



(126) 1 

1... 
.1.. 
.1. 



.1 . 
... 1 

.. .1 



(127) 1 

1.. 
.1. 



(128) 1 
1. 






1. . 
.1 . 

.. 1 
.. .1 



(129) 1 

.1.. .. 

.1. . . 

.1 .. 

.. 1. 

.. .1 

.. ..1 



Field 

Name 

DCMRTME 



DCMSEGDF 

DCMRNUMD 

DCMRTMED 

DCMASKEN 

DCMASKCN 

DCMASKCR 

DCMASKLP 

DCMASKPF 

DCMOPTST 
DCMOPTVR 
DCMOPTAD 
DCMOPTSG 
DCMOPRLL 

DCMCS 

DCMCSC 

DCMCSO 

DCMUTILT 

DCMDSTAT 

DCMDSTFL 

DCMUNVW 

DCMDSTNM 

DCMDSTNH 

DCMDSINR 

DCMDSAUT 

DCMMCSST 

DCMDUSE 

DCMNOHRD 

DCMOOMSS 

DCMOOSDS 

DCMIOUNQ 
DCMI0226 
DCMRPCUR 
DCMFRSCN 
DCMRDARM 
DCMW2250 
DCMINNOR 
DCMINERR 

DCMIOCM1 
DCMDORMI 
DCMSOUND 
DCMWRWRN 
DCMWRMSG 
DCMWRPAR 
DCMWRINS 
DCMWRENT 
DCMINSC 



Field Description 

Contains the current value of the RTME parameter of 

the CONTROL S command (numerical value) . 

The default value for SEG. 

The default value for RNUM. 

The default value for RTME. 

The ENTER mask. 

The CANCEL mask. 

The cursor mask. 

The light pen mask. 

The PFK mask. 

Screen control option flags. 
Delete verification (Y=l; N=0) . 
Automatic deletion (Y=l; N=0). 
Default SEG specified. 
Roll mode specified. 

Open/Close request. 
Close requested. 
Open requested. 

Reserved. 

Current display status flags. 

Full screen. 

UNVIEWABLE MESSAGE written to screen. 

Messages are numbered. 

Messages numbered - HOLD option. 

Intervention requested deletion tried. 

Automatic deletion tried. 

MCS Interface flags. 
Status Display Support. 
NO HARDCOPY message written. 
Message stream entry. 
Status display entry. 

Device I/O information flags. 
(2260) RMI performed. 
(2260) Advance cursor to blanks. 
(2260) Put output in hold mode. 
(2250) Perform read after RMI. 
(2250) Device is a 2250. 
(2250) Normal instruction line. 
(2250) Error instruction line. 

I/O Communications byte 1. 
Issue RMI. 
Sound alarm. 
Write warning line. 
Write full message area. 
Write partial message area. 
Write instruction line. 
Write entry area. 
Insert cursor. 
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Bytes and 


Field 


Offset 


Bit Pattern 


Name 


298 


(12A) 


1 




DCMIOCM2 






1... 


• • . . 


DCMBLENT 






• 1.. 


• • • • 


DCMBLWRL 






-.1. 


.... 


DCMBLWRR 






...1 


• • • • 


DCMINSSH 






• • • • 


1... 


DCMWINFD 






«... 


.1.. 


DCMERASE 








..1. 
.•.1 


DCMIOCRD 
DCMWRASY 


299 


(12B) 


1 




CCMIOCM3 






1... 


• • • • 


DCMOPRMI 






.1.. 


• • • • 


DCMSSRG 






..1. 


• • • • 








...1 


• • • • 


DCMWRPFK 






• • • • 


1... 


DCMPFKAT 






• • • • 


.1.. 


DCMRDPFK 








..1. 

...1 


DCMACPFK 
DCMLTPFK 


300 


(12C) 


1 




DCMLINEN 


301 


(12D) 


1 




DCMCULNO 


302 


(12E) 


1 




DCMPOSCU 


303 


(12F) 


1 




DCMASYNC 






1... 


• • • • 


DCMASCAN 






.1.. 


• • • • 


DCMASDA 






..1. 


• • • • 


DCMASIN 






...1 


.... 


DCMASBA 









1... 


DCMASLOG 


304 


(130) 


1 
1... 




DCMCOM1 
DCMLPENT 






.1.. 


• • • • 


DCMIOPRD 






..1. 


• • • • 


DCMCOMRM 






• ..1 


• • • • 


DCMCONAU 






• . • • 


1... 


DCMCOMRD 






• • • • 


• 1.. 


DCMCOMNM 






• • • • 


..1. 











...1 


DCMCANCL 


305 


(131) 


1 




DCMCOM2 






1... 


.... 


DCMCM2I 






.1.. 


• • • • 


DCMSPLIT 






..1. 


• • • • 


DCMCOMAR 






.,.1 


• • • • 


DCMCLOSE 






• • • • 


1... 


DCMERPF 






• • • . 


.1.. 


DCMCMIN5 






• . • • 


..1. 
...1 


DCMBLNK 
DCMAE 


306 


(132) 


1 




DCMCOM3 






1... 


• • • • 


DCMCDSP3 






.1.. 


• • • • 


DCMRTPFK 






..1. 


• • • • 


DCMVLPFK 






...1 


• • • • 


DCMXINT1 






• • • • 


1... 


DCMOLUNV 






• • • • 


.1.. 


DCMPFKWR 






• • • • 


..1. 








• • • • 


...1 


DCMCMIN7 



Field Description 

I/O Communications byte 2. 

Blank entry area. 

Blank left half of warning line. 

Blank right half of warning line. 

Initialize and shift instruction line. 

Write informational display. 

Perform erase. 

Perform read. 

Write asynchronous error message to mid- screen, 

I/O Communications byte 3. 

RMI after OPEN to unlock keyboard. 

Suppress start regeneration. 

Reserved. 

Write PFK area. 

PFK attention. 

PFK area read. 

Turn active PFK lights on. 

Turn all PFK lights on. 

Line numbers to begin write. 

Line in entry area to insert cursor. 

Position to insert cursor. 

Asynchronous error retry flags. 

Asynchronous error message on screen. 

Retry bit. 

Retry bit. 

Retry bit. 

Log asynchronous error. 

Communications byte 1. 

Enter by light pen or cursor. 

Read performed. 

RMI performed. 

Perform automatic deletion. 

Perform regular delete. 

Number messages. 

Reserved. 

Indicate CANCEL to Command routine. 

Communications byte 2. 

Input to be processed. 

Message to be split. 

Accepted reply. 

Cleanup for close. 

Erase performed; close device. 

Return to Interface 5 for blanking. 

Blanking required. 

Cleanup for asynchronous error. 

Communications byte 3. 

Display 3 work complete. 

Return to PFK routine. 

Verifying last command. 

Entry for Interface 1 routine. 

Out-of-line message caused UNVIEWABLE MESSAGE. 

Write PFK updates to library. 

Reserved. 

Return to Interface 7 for blanking. 
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Bytes and 
Offset Bit Pattern 
307 (133) 1 

1.. 
.1. 

1 .. 
. 1. 

• .1 
. ..1 

• • • • JL 



308 (134) 1 
1. 



■ x • • • 

..1 .. 

... 1. 

... .1 



309 (135) 1 

1 

.1.. .. 

. . x . • 



312 (138) 

313 (139) 1 

314 (13A) 1 
316 (13C) 2 

318 (13E) 2 

320 (140) 2 

322 (142) 2 

324 (144) 2 

326 (146) 2 



Field 

Name Field Description 

DCMCMSG1 Message Module Communications byte 1. 

DCMMSGWT Move in MESSAGE WAITING. 

DCMUNMSG Move in UNVIEWABLE MESSAGE. 

DCMCHOPT Move in CHANGE OPTIONS. 

DCMELONG Move in ENTRY TOO LONG. 

DCMWRCDL Move in CON=N, DEL=Y. 

DCMDELNT Move in DEL UNCHANGED, NO TIMER. 

DCMMNHRD Move in NO HARDCOPY. 

DCMCMSG2 Message Module Communications byte 2. 

DCMDLREQ Move in DELETION REQUESTED. 

DCMRQINC Move in REQUEST INCONSISTENT. 

DCMMSGCR Move in INVALID CURSOR OPERATION. 

DCMINVOP Move in INVALID OPERAND. 

DCMCILLP Move in ILLEGAL LIGHT PEN OPERATION. 

DCMDELRI Move in DELETE REQUEST INCONSISTENT. 

DCMASYRT Move in ASYNCHRONOUS ERROR RETRYABLE. 

DCMASYCD Move in ASYNCHRONOUS ERROR MAY BE RETRYABLE. 

DCMCMSG3 Message Module Communications byte 3. 

DCMCNRLL Move in ROLL MODE. 

DCMCDLR1 Move in NO DELETABLE MESSAGES. 

DCMCDLR2 Move in INVALID RANGE. 

DCMCDLR3 SEG equal to zero. 

DCMCDLR4 Display not on screen. 

DCMCDLR5 Invalid operand. 

DCMNHCIN Move NO HARDCOPY message to instruction line. 

DCMDTBSY COMMAND REJECTED — TASK BUSY. 



310 (136) 1 DCMCMSG4 

1 DCMPFKNA 

.1 DCMPFKND 

..1 DCMPFKNO 

... 1 .... DCMPFKIP 

311 (137) 1 DCMSVC34 

1 DCMMYCMD 

.1 DCMINVLD 

..1 DCMTYPE1 



DCMIORTN 

DCMTEST 
DCMBASRT 

DCMBAMI 

DCMBAPFK 

DCMBAINS 

DCMBAENT 

DCMBAWRN 



Message Module Communications byte 4 . 
Move in PFK NOT ALLOCATED. 
Move in PFK NOT DEFINED. 
Move in NO PFK ALLOCATION. 
Move in PFK IN PROCESS. 

SVC 34 Communications byte. 

Command to be handled by this console. 

Invalid K command. 

K command is not routable. 

Reserved. 

Indicates which I/O routine handles I/O for the 
console. 

Reserved for testing. 

Location in buffer for start of the channel program 
regeneration orders. 

Location of first message line for use by the channel 
program. 

Location of the PFK display line in the buffer for 
use by the channel program. 

Location of the instruction line in the buffer for 
use by the channel program. 

Location of the entry area in the buffer for use by 
the channel program. 

Location of the warning line in the buffer for use by 
the channel program. 
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Offset 



Bytes and 
Bit Pattern 



328 (148) Variable 



Field 

Name 

Buffer 

address 

table 



Variable Channel Program Area 
Variable Screen Image Buffer 



Variable 


DOM Identification 




Number 




Variable 


Screen Control Table 




First Byte 






1... 


.... 


DCMMSGWR 




.1.. 


• . • • 


DCMMSGIN 




• •1. 


• • • • 


DCMMSGCN 




.•.1 


• • • • 


DCMMSGJK 






1... 


DCMMSGAD 




• • • • 


.1.. 


DCMMSGRD 




• • • • 


• .1. 


DCMMSGIF 






...1 


DCMMSGST 




Second Byte 






1... 


• • • • 


DCMMSGAC 




.1.. 


• • • • 


DCMMSGC7 




..1. 


• • • • 


DCMMSGDM 




.•.1 


• • • • 


DCMMSGAR 




• • • • 


1... 


DCMMSGIR 




• • • • 


.1.. 


DCMMSGCT 




• • • • 


..1. 


DCMMSGPP 






...1 


DCMMSGCL 


Variable 


Secor 


idary Screen 



Control Table 



1. 
.1. 



DCMSECCL 
DCMSECLL 
DCMSECDL 
DCMSECBL 
DCMSECDD 
DCMSECST 



Field Description 

Addresses of the buffers for the 

control fields. 



various display 



Work area for the channel program. 

Contains a copy of the display screen. 

Contains information pertaining to delete-operator- 
message (DOM) messages. 

Contains one two-byte entry for each line in the 
screen image buffer. Each entry contains flags indi- 
cating the content of the line. 



WTOR Message displayed inline. 
Message displayed inline. 
Message continued on next line. 
To write out-of-line display. 
Message can be deleted automatically. 
Request has specified message to be deleted. 
Informational message inline. 
End of table indicator. 



Action message. 
Descriptor code 7 message. 
Message has been DOMed. 
Message is an accepted reply. 
Intervention required message. 
Continuation line. 
Issued by problem program. 
Control line of inline MLWTO. 

Contains a one-byte entry for each line in the mes- 
sage area of the screen. Each entry contains flags 
pertaining to out-of-line (display area) messages. 
Control line of out-of-line display. 
Label line of out-of-line display. 
Data line of out-of-line display. 
This line is blanked. 
Line reserved for dynamic display. 
End of table indicator. 



The following table indicates the sizes in bytes of the fields of the "device depen- 
dent" portion of the TDCM. 



Field 



j. 

(Buffer Address Table 

I 

l< 

I 

| Screen Image Buffer 

I 

| DOM ID Numbers 

I 

| Screen Control Table 

I 

(Secondary Screen Control Table 

I— 



|2260*-|2260 2 |2250| M85| 



ICCW Area 



1 o 


o 1 


| 80 


80 | 


| 960 


960 | 


| 44 


44 | 


| 22 


22 | 


| 11 


11 | 



| ^input/output 
| 2 output-only 



10| 8| 

I I 
112| 72| 

I I 
3866|2800| 

I 1 
188| 120| 

I I 

94| 60| 

I 
30| 



47! 
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ENTRY TABLE (ENTAB) 



Unconditional branch to last entry- 
BC 15, D1SP (15,0) 



Address of referred to symbol 



"to" seg 
number 



8 



Previous Caller 
(zero initially) 



12 



Unconditional branch to last entry - 
BC 15, DISP(15,0) 



Address of referred to symbol 



16 



"to" seg 
number 
20 



21 



Previous Caller 

(zero initially) 

22 



23 



Unconditional branch to last entry- 
BC 15, DIPS (15,0) 



Address of referred to symbol 



"to" seg 
number 



Previous Caller 
(zero initially ) 



Last 
Entry 



SVC 45 
instruction 



L 15,4(0,15) Loads GR15 with 
the value of the ADCON. 



BCR 15, 15 



"from" 
seg no. 



Address of segment 
table (SEGTAB) 



2 bytes 



2 bytes 



-< 2 bytes —^r 



< 2 bytes 



:1 byte > 



3 bytes 



NOTE: DISP = is the displacement, in bytes, of this entry from the last entry. 

"to" segment number — is the number of the segment containing the symbol being referred to. 
"from" segment number — is the number of the segment that contains this entry table. 
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EVENT CONTROL BLOCK 



Offset 




Bytes and 
Bit Pattern 
1 

.1 

. • XX xxxx 



0111 1111 

0100 0001 

0100 0010 

0100 0100 

0100 1000 

0100 1111 



0111 1111 
0100 0001 
0100 1000 



Field Description 

Awaiting completion of an event: 

W - Waiting for completion of an event. 

After completion of an event: 

C - The event has completed. 

Completion code. 

One of the following completion cedes will appear at the comple- 
tion of a channel program: 

Access Methods Other Than BTAM 

Channel program has terminated without error. (CSW contents 
useful. ) 

Channel program has terminated with permanent error. (CSW con- 
tents useful.) 

Channel program has terminated because a direct access extent 
address has been violated. (CSW contents do not apply.) 
Channel program has been intercepted because of permanent error 
associated with device end for previous request. You may reissue 
the intercepted request. (CSW contents do not apply.) 
Request element for channel program has been made available after 
it has been purged. (CSW contents do not apply.) 

Error recovery routines have been entered because of direct access 
error but are unable to read home address or record 0. (CSW con- 
tents do not apply.) 

BTAM 

Completed normally 

Completed with an I/O error 

Enable command halted , or, I/O operation purged. 



Awaiting completion of an event: 
After completion of the event: 



Request block address. 

or remainder of completion code. 
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FREE QUEUE ELEMENT (FQE) 



Pointed to by the boundary box for a job step task TCB f or by the FQE describing the 
next higher free area. 



Offset 
(0) 

4 (4) 



Bytes and 
Bit Pattern 



Field 
Name 



Field Description 

Address of FQE describing the next lower free area in 

main storage. 



FQEPTR 

FQELNGTH Number of bytes in described free area 



GOTTEN SUBTASK AREA QUEUE ELEMENT (GQE) 

Pointed to by the boundary box for a subtask TCB, or by a subsequent GQE. 



Offset 



(0) 

(4) 



Bytes and 
Bit Pattern 
4 

4 



Field 

Name 

GQEPTR 

GQELNGTH 



Field Description 

Address of previously created GQE. 

Number of bytes in described area. 



INTERRUPTION QUEUE ELEMENT (IQE) 



Offset 
(0) 


Bytes and 
Bit Pattern 

1 


Field 
Name 


1 (1) 


3 






IQELNK 


4 (4) 


4 






IQEPARAM 


8 (8) 


1 








9 (9) 


3 






IQEIRB 


12 (C) 


1 








13 (D) 


3 






IQETCB 



Field Description 
Reserved. 

Address of the next IQE on the IQE queue. 

The parameter that is to be passed to the asynch- 
ronous exit routine. 

Reserved. 

Address of the IRB that is to be scheduled for this 
request. 

Reserved. 

Address of the TCE for this request. 
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MESSAGE INFORMATION LIST FOR TYPE-1 SVCS 



Offset 



-4 





(-4) 
(0) 



Bytes and 
Bit Pattern 
4 

4 



Field 
Name 



INFTCB 



Field Description 

Address of end of Message Information List. 

Address of the TCB for which the information is 
pertinent. 

Return address in the calling routine (from register 
14) if entry to the type-1 SVC routine was by a 
branch instruction. 



Reason code (0=no reason code). 
Number of bytes of variable data. 

INFBADDR contains a valid address. 

System completion code. 

Information to be provided to the user. This field 
is always 16 bytes long, but the information may be 
less than 16 bytes. 

Note ; The above description is for one entry in the Message Information List. Each 
additional entry in the list will have the same format as offsets through 27. 



4 


(4) 


4 


INFBADDR 


8 


(8) 


1 

XXX. .... 

... X xxxx 


INFRCL 


9 


(9) 


1 

JL... .... 


INFFLG 


10 


(A) 


2 


INFCC 


12 


(C) 


16 


INFVAR 



PROGRAM INTERRUPTION CONTROL AREA (PICA) 



Pointed to by PIEPICA field. 



Offset 
(0) 



(0) 



1 (1) 



4 (4) 



Bytes and Field 
Bit Pattern Name 



, . xxxx 



PICAPRMK 



PICAEXIT 



PICAITMK 



Field Description 



Program mask to be used in the PSW when the programs 
of the task are executing. 

Address of the user's program interruption exit rou- 
tine to be given control when a program interruption 
of a specified type occurs. 

Bits 33 through 47 are used to indicate on which pro- 
gram interruption types the exit routine is to be 
used. The bits are numbered through 15, left to 
right. A bit set to one indicates that the error 
handling routine is to be used. 
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PROGRAM INTERRUPTION ELEMENT (PIE) 



Pointed to by TCBPIE field. 



Bytes and Field 
Offset Bit Pattern Name 






(0) 


1 




1 


(1) 


3 


PIEPICA 


4 


(4) 


8 


PIEPSW 


12 


(C) 


4 


PIEGR14 


16 


(10) 


4 


PIEGR15 


20 


(14) 


4 


PIEGRO 


24 


(18) 


4 


PIEGR1 


28 


(1C) 


4 


PIEGR2 



Field Description 

Flag byte. 

The task cannot accept further program interruptions. 

This bit is set whenever a user program interruption 

exit routine is entered. 

Address of the current PICA. 

Program interruption old PSW (stored at the program 
interruption) . 

Save area for register 14. 

Save area for register 15- 

Save area for resgiser 0. 

Save area for register 1. 

Save area for register 2. 
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MACHINE CHECK RECORD FOR SERO AND SER1 



SERO and SER1 produce two types of record entries corresponding to the two types of 
errors processed: machine-check and channel errors. Record size varies with the type of 
record and with the machine model. The formats of the machine-check record produced by 
SERO and SERl is: 



Offset 
(0) 



(1) 



(2) 



(6) 



7 


(7) 


8 


(8) 


12 


(C) 


16 


(10) 


17 


(11) 


20 


(14) 


22 


(16) 


24 


(18) 



Bytes and 
Bit Pattern 

1 

X^vX2£ • • ■ • 

xxxx . . 1 . 
xxxx 1 . . . 
xxxx 1 . . 1 
xxxx 1.1. 
xxxx 1.11 



... X aJvaX 

. . lx xxxx 
bits 3-7 
0-1F 

4 

Byte 



1... 

0... 
.1.. 
..1. 



i . Ji. . Jrv JvX 



Byte 1 : 

1.. .. 
1. .. 
.1 .. 
.. 1. 
.. .1 



Bytes 2-3 : 
1 

1 
4 
4 
1 
3 
2 
2 



Field 

Name 

CLASRC 



SYSREL 



Switches 



RCDCNT 



DATE 
TIME 

CPUSER 

CPUID 

MCELLNG 

PROGID 



Field Description 

Machine Check Record. 

MCH. 

Converted MCH. 

SERl. 

SERO. 

Converted SERl. 

Converted SERO. 



OS. 
DOS. 

Release level 0-31. 



More records follow. 
Last record. 
Time-of-Day clock. 
Extended control mode. 
Time macro used (HHMMSS). 
Unassigned. 



Short form of record. 

Record incomplete. 

System terminated. 

First record of two record recording. 

Channel record included. 

Portion of data overlay ed. 

External machine check. 

Unassigned. 

Reserved. 

Bits 0-3 contain the sequence number of a physical 
record. Bits 4-7 contain the total number of phys- 
ical records in this logical record. 

Reserved. 

The system date the record was made. 

The system time the record was made. 

Reserved. 

CPU serial number (for System/370 only) . 

CPU identifier (40, 50, etc.). 

Maximum Machine Check Extended Log length (for 
System/370 only) . 

The module name of the program being processed and/ 
or requesting service at the time of the error. 
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Bytes and Field 
Offset Bit Pattern Name 



32 


(20) 


8 


JOBID 


40 


(28) 


8 


PSW 


48 


(30) 


Variable 


LOGOUT 






Variable 


DAMAGE 



Field Description 

The name assigned to the job being executed at the 

time of the failure. 

The Machine Check Old PSW. 

Register contents and hardware logout information. 
Logout size and format is model dependent. 

Recovery Management Support's assessment of damage 
to the system. 



CHANNEL ERROR RECORD FOR SERO AND SERl 



Offset 
(0) 


Bytes and 

Bit Pattern 

1 

0010 .... 

.... 1000 

1001 


Field 
Name 


1 (1) 


1 

000. 








...X 


xxxx 




2 (2) 


2 








Byte 
1. .. 









.XXX 


xxxx 






Byte 
1... 
.1.. 
..1. 
...1 


1 
1... 








.XXX 




4 (4) 


4 






8 (8) 


4 






12 (C) 


4 






16 (10) 


1 






17 (11) 


3 






20 (14) 


2 






22 (16) 


2 






24 (18) 


8 







32 (20) 16 

48 (30) 8 
56 (38) 8 



Field Description 
Class and source. 
Channel-check record. 
SERl. 
SERO. 

System and release. 

System/360. 

Release level (0 through 31) , 

Flags: 



Operator action message. 
Reserved. 



Message required. 

Record incomplete. 

System terminated. 

Channel unsupported or failed to log. 

Invalid CUA. 

Reserved. 

Reserved. 

System date when failure occurred. 

System time when failure occurred. 

Reserved. 

CPU serial number (not used for S/360). 

CPU model number. 

Reserved. 

Name assigned to the job being executed at the time 
of failure. 

List of eight devices (channel and unit addresses) 
that were busy when failure occurred. 

CCW that was being executed when failure occurred. 

CSW that was stored following the detection of the 
I/O failure. 
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Bytes and 


Field 


Offset 


Bit Pattern 


Name 


64 (40) 


4 






68 (44) 


4 






72 (48) 


1 








0000 


0001 






0000 


0010 






0000 


0011 






0000 


0101 






0000 


0110 






0000 


0111 






0000 


1010 




73 (49) 


3 






76 (4C) 


4 






80 (50) 


variable 





Field Description 
Reserved. 

Device type at time of failure (obtained from UCB) . 

Flags used to identify channel at time of failure: 

Integrated multiplexer. 

Integrated selector. 

Integrated block multiplexer. 

Stand-alone selector 2860. 

Stand-alone multiplexer 2870. 

Block multiplexer 2880. 

Integrated file adapter. 

Channel and unit address of the I/O device at time of 
failure. 

Reserved. 

Channel logout associated with the I/O failure caus- 
ing the channel failure. Size is model and channel 
dependent. 
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REQUEST BLOCKS 



Bytes and Field 
Offset Bit Pattern Name 



-12 (-C) 4 



-8 (-8) 4 



XRBQMAJ 



XRBSUC 



-4 (-4) 4 



XRBPRE 



(0) 8 



XRBNM 



Field Description 

LPRB: MFT with subtasking only. The address of the 
major RB for the program that contains the embedded 
entry point established by the IDENTIFY macro 
instruction that created this LPRB. 

Load list pointer: If this RB is for the first pro- 
gram loaded, this field is 0. Otherwise, this field 
contains the address of the XRBSUC field in the RB 
for the program loaded just prior to the program 
represented by this RB. 

Load list pointer: If this RB is for the most 
recently loaded program, this field contains the 
address of the TCBLLS field in the TCB. Otherwise, 
this field contains the address of the XRBSUC field 
in the RB for the program loaded immediately after 
the program represented by this RB. 

Contents of this field depend on the use of this re- 
quest block. The use of this request block is shown 
by bits 0-3 of byte 1 of the XSTAB field at offset 10 
(X'A' ). 



IRB 

For timer, 1st byte contains flags; for all other 

uses, contains no meaningful information. 



Program name. 



SIRB 



8 character name of the error routine currently occu- 
pying the 400 byte I/O supervisor transient area. 



SVRB 

Type 2 SVC: 



No meaningful information. 



(0) 

4 (0) 

8 (8) 
10 (A) 



XRBSZ 



XSTAB 



Type 3 or 4 SVC: TTRN address, on the SVC library, of 
the load module. N, the concatenation number, is 0. 

Four digit number of the form ysss. 

y - Number of the current phase of the routine. 

(First or only phase: y = 0.) 
sss - SVC number in unpacked decimal (signed) form. 

The number of contiguous doublewords occupied by the 
RB, the program (if applicable) , and associated 
supervisor work areas. Does not include program size 
if a program extent list is present. 

Flag bytes. 



Byte : 
xxxx . . 



0000 ., 



0001 



0010 



These bits are used to distinguish the LRB, LPRB, 
PRB, IRB, SIRB, and SVRB. These bits have the fol- 
lowing definition: 

PRB: The program was not loaded via a LOAD macro 
instruction and does not have minor entries identi- 
fied via an IDENTIFY macro instruction. 
PRB: The program was not loaded via a LOAD macro 
instruction and does have minor entries identified 
via an IDENTIFY macro instruction. 
LPRB: The program was loaded via a LOAD macro 
instruction and does not have minor entries identi- 
fied via an IDENTIFY macro instruction. 
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Offset 
10 (A) 
(cont. ) 



Bytes and Field 
Bit Pattern Name 
0011 



0100 

0101 

1000 

1100 

1101 

1110 

1111 

1. 



1.1. 



Field Description 

LPRB: The program was loaded via LOAD macro 

instruction and does have minor entries identified 

via an IDENTIFY macro instruction. 

IRB 

FRB 

SIRB 

SVRB: The program is a type 2 SVC routine or a type 

3 or 4 SVC routine that has not yet been loaded. 

SVRB: The program is a type 3 or type 4 SVC routine 

that has been loaded. 

LPRB: This block describes a minor entry identified 

via an IDENTIFY macro instruction. 

LRB 

The type 3 or 4 SVC routine is resident. 

A checkpoint may be taken in a user exit from this 

SVC routine. 

LRB, LPRB, PRB: 

The program was hierarchy block loaded. A program 

extent list exists. 

IRB: The IRB represents an End-of-task exit routine. 

Refreshable module. 



Byte 


1: 


0... 
1... 
.0.. 


• • 



.1., 



. .XX 


xxxx 


Byte 


2: 


1... 


.... 


.1.. 


.... 


..1. 


.... 


...1 


• • • • 


• • • • 


00.. 


• • • • 


01.. 



10.. 










• • • • 


...1 
.. .0 


12 


(C) 


4 




12 




1 





XRBWLE 



XRBUSE 



FRB only: 

Module being loaded is reenterable. 

Module being loaded is not reenterable. 

The Finch routine has not executed a GETMAIN macro 

instruction. 

The Finch routine has executed a GETMAIN macro 

instruction. 

(Reserved bits) 

All RBs except FRBs: 
XRBLNK field points to the TCB. 
Active program. 

Registers 2-14 to be restored from XRBREG. 
Reenterable or reusable program. 
IRB has no interrupt queue elements. 
IRB has interrupt queue elements which are request 
elements . 

This is a dummy LPRB, in a partition, for a program 
in the reenterable load module area. The LPRB for 
the program is in the reenterable load module area. 
IRB has interrupt queue elements which are not re- 
quest elements. 

Request block storage is to be freed when program 
returns. 

Wait on less than the number of specified events. 
Wait on a single event or all of the specified 
events . 

FRB only: 

Address of the most recent wait list element. 

Use count (the number of loads via the LOAD macro 
instruction less the number of deletes via the DELETE 
macro instruction) . 



13 (D) 



XRBEP Entry point address. 

End of LRB 

(Unless the program was hierarchy block loaded - 
XSTAB byte bit 6 on.) 

Program Extent List 

(If the program was hierarchy block loaded, the fol- 
lowing fields exist.) 
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Offset 
16 (10) 


Bytes and 
Bit Pattern 
4 


Field 

Name 

XLISTLHO 


20 (14) 


4 






XLISTLH1 


24 (18) 


4 






XLISTAHO 


28 (1C) 


4 






XLISTAH1 



16 


(10) 


8 


16 


(10) 


4 


20 


(14) 


4 



Field Description 

The length in bytes of that part of the program con- 
tained in hierarchy 0, This does not include the RB 
length. 

The length in bytes of that part of the program con- 
tained in hierarchy 1. 

The address of the program extent contained in 
hierarchy 0. It is not the address of the RB. 

The address of the program extent contained in 
hierarchy 1. 

End of the LRB Program Extent List 

XRBPSW User's old PSW. 

XRREQ FRB only : Address of the TCB for the task which 
requested that the module be loaded. 

XRTLPRB FRB only : Address of the LPRB build by Finch for the 
program which has been brought in by a LOAD macro 
instruction. 

End of the FRB 

24 (18) 40 XBQ IRB : Address of a 12 byte or 16 byte request 

element. 

LPRB : Address of an LPRB describing an entry identi- 
fied by the IDENTIFY macro instruction. 

PRB : Address of an LPRB describing an entry identi- 
fied by the IDENTIFY macro instruction. 

SIRB : Address of a 12- byte or 16-byte request 
element. 

SVRB : For type 3 and type 4 SVCs, this field con- 
tains the size of the program in bytes. 

28 (1C) 1 XRBWT Wait count. 

29 (ID) 3 XRBLNK Primary (active) queuing field. Address of the pre- 

vious RB for the task. Address of the TCB if this is 
the first or only RB on the queue. 

End of LPRB and PRB 

(Unless the program was hierarchy block loaded - 
XSTAB byte 1 bit 6 on.) 

Program Extent List 

(If the program was hierarchy block loaded, the fol- 
lowing fields exist.) 

32 (20) 4 XLISTLHO The length in bytes of the program extent contained 

in hierarchy 0. This does not include the RB length. 

36 (24) 4 XLISTLH1 The length in bytes of the program extent contained 

in hierarchy 1. 



404 



Offset 
40 (28) 


Bytes and 
Bit Pattern 
4 


Field 

Name 

XLISTAHO 


44 (2C) 


4 


XLISTAH1 



Field Description 

The address of the program extent contained in 

hierarchy 0. It is not the address of the RB. 

The address of the program extent contained in 
hierarchy 1. 

End of LPRB, PRB Program Extent List 

32 (20) 64 XRBREG IRB, SIRB, SVRB : Save area for 16 general registers 

(0-15) 

96 (60) nx8 SVRB : Ah extended save area, up to 6 doublewords, 

requested for SVC routine. 
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REPLY QUEUE ELEMENT 



Offset 
(0) 


Bytes and 
Bit Pattern 
4 


Field 

Name 

RQERQE 


4 (4) 


2 




RQEID 


6 (6) 


1 




RQEXA 




• • • • 


...0 






• •.1 








.•1. 


• • • • 




7 (7) 


1 

1000 
0100 
0001 
0000 


0000 
0000 
0000 
1000 


RQEAVAIL 



8 (8) 



12 


(C) 


4 


12 


(C) 


4 


16 


(10) 


1 


17 


(11) 


3 


20 


(14) 


4 



RQETCB 

RQEXB 

RQEWQE 

RQELNGTH 

RQEPTR 

RQEECB 



Field Description 

Address of next reply queue element. 

Reply identification number. 



Associated reply will be purged. 

Cancel message exists. 

WTOR issued under protection key (MCS only) . 

Buffer flags (this field exists only with MCS). 

Buffer is free. 

Buffer is in use. 

Buffer was obtained dynamically. 

Buffer has been serviced. 

Address of TCB of task that issued the message with 
which this reply is associated. 

Non-MCS: address of purging message buffer. 

MCS: address of associated WQE. 

Maximum length of reply. 

Address of user's buffer. 

Address of user's ECB. 



REQUEST QUEUE ELEMENT (RQE) 



Offset 
(0) 


Bytes and 
Bit Pattern 
2 


Field 

Name 

RQELNK 


2 (2) 


2 

XXXX XXX. 


RQEUCB 


4 (4) 


1 

1111 1111 




5 (5) 


3 


RQEIOB 


8 (8) 


1 


RQEPRI 


9 (9) 


3 


RQEDEB 


12 (C) 


1 




13 (D) 


3 


RQETCB 



Field Description 

Address of next RQE on the queue. 



Address of UCB. 

This RQE represents a request for a system error rou- 
tine that operates under an SIRB. 

Free List indicator. 

Indicates that the RQE is on the Free List (X f 00 f 

indicates not on Free List) . 

Address of the associated IOB. 

Dispatching priority of the requesting task. 

Address of the associated DEB. 

Protection key of requesting task. 

Address of the TCB with which the I/O request is 
associated. 
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SEGMENT TABLE (SEGTAB) 



Pytes 


TEST 
ind . 


Bit 1 = 0: Not in Test 
Bit 1 = 1: In Test 


Address of data control block (DCB) used to load module * 
1 


4 





Address of note list 


* 


8 


Last segment number of 
region 1 


Highest segment no. in 
storage- region 1 
9 


Last segment 
number of region 2 
10 


Highest segment no. in 
storage-region 2 
11 


12 


Last segment number of 
region 3 


Highest segment no. in 
storage-region 3 
13 


Last segment 
number of region 4 
14 


Highest segment no. in 
storage-region 4 
15 


16 


Address of ECB to be posted when SEGLD request has been serviced * 


20 


Reserved 


* 


24 


Previous segment * 
number for segment 1 


25 


Status 
Indctr 


28 


Previous segment 
number for segment 2 


Address of entry table entry (when caller chain exists) * 
29 


Status 
Indictr 



Previous segment number 
for segment N 



Address of entry table entry (when caller chain exists) 



Status 
Indctr 



4 bytes 
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STAE CONTROL BLOCK CSCB) 



Pointed 


to 


by TCBNSTAE 


field. 


Offset 
(0) 




Bytes and 
Bit Pattern 
1 


Field 
Name 


1 (1) 




3 






4 (4) 




4 






8 (8) 




1 

.... 

.... 


.1.. 
..00 
..01 
..10 





(9) 



Field Description 

STAE flag byte for previous SCB for this task; or 

if this is the first SCB created for this task. 

Address of previous SCB or # if none, address of TCB. 

Address of the user-written STAE exit routine. 

I/O flags. 

Allow asynchronous interruptions. 

Quiesce I/O. 

Halt I/O. 

Bypass I/O intervention. 

Address of the parameter list to be passed to the 
STAE exit routine. 



12 (C) 



13 (D) 



1 



SCB will not be canceled by the exit routine when 
XCTL is issued. 
ISAM/TAM Switch. 

Address of the request block of the task that issued 
the STAE. 



STAE PARAMETER LIST 



Pointed 


to 


by STAE control bio 






Bytes and 


Field 


Offset 




Bit 


Pattern 


Name 


(0) 




1 
1.. 

0.., 


. .1.. 
. ..00 
. ..01 
. ..10 




1 (1) 




3 






4 (4) 




4 







Field Description 

Flags . 

STAI parameter list (valid in MVT only) . 

STAE parameter list. 

Allow asynchronous interruptions. 

Quiesce I/O. 

Halt I/O. 

Bypass I/O processing. 

Address of the STAE exit routine. 

Address of the STAE exit routine parameter list. 
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STORAGE UTILIZATION BLOCK 



Offset 
(0) 


Bytes and 
Bit Pattern 
1 


Field 
Name 
. SUBDAIO 


1 (1) 


1 




SUBFLGS 




1... 


.... 






.1.. 


.... 






• • • • 


1... 




2 (2) 


2 




SUBNUM 


4 (4) 


4 




SUBDOM 


8 (8) 


4 




SUBPBASE 


12 (C) 


4 




SUBTIOT 



16 (10) 



Field Description 

I/O routine is in use. 

Exit to Processor 1 routine. 
Initialize SUB on first entry. 
Write PFK updates. 

Number of transient consoles. 

Address of SUBKEY field in SUB. 

Address of the base DCB. 

Address of the task I/O table (in the Transient DCM 
control block of the SUB) . 

SUBSPACE Address of the SUB work area (SUBAREA) . 



The following fields are generated only if transient DCMs have been defined for the 
system. 

Address of the DCM request queue (SUBREQ) . 

Address of the DCM BLDL list (SUBTTR) . 

Address of the DCB (in the transient DCM control 
block) . 

Address of the PFK area. 

Delete Operator Message (DOM) elements; each DOM ele- 
ment is two bytes long, there is one DOM element for 
each display console in the system. 

Work area required by the SUB (CXSA save area, work 
area, two register save areas). 

DCM request elements; there is one 4- byte element for 
each console in the system that has a transient DCM. 

DCM BLDL elements; there is one 8-byte element for 
each transient DCM in the system. 



20 


(14) 


4 


SUBQUE 


24 


(18) 


4 


SUBBLDL 


28 


(1C) 


4 


SUBBLK 


32 


(20) 


4 


SUBPFKAD 


36 


(24) 


2(n) 


SUBKEY 



36 

4(n) 

8(n) 



SUBAREA 

SUBREQ 

SUBTTR 



Each of the following areas is expanded only if the associated type of display console is 
included in the system: 



64 



44 



24 



364 



142 



SUB2260 RMS/SER channel programs for the 2260 display 
consoles. 

SUB2250 RMS/SER channel programs for the 2250 and Model 91 
display operator consoles. 

SUB5450 RMS/SER channel programs for the Model 85 and Model 
165 operator consoles. 

SUBDCB Transient DCM control block; contains information 

pertaining to transient DCMs. This area is included 
only if transient DCMs are in the system. 

SUBDCMB Base DCM; contains executable code which gains con- 
trol whenever an STIMER interval elapses. This rou- 
tine sets flags in the DCM and POSTs the DCM for the 
Timer/ Interpreter routine. 
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SUPERVISOR RECORD (SUR) 



r 



48 49 
— T — T - 



52 
— 1 



First 48 bytes of the user's Task Control Block 



I I FSA | 
I I I 

-JL-.-JL 






Reserved J | 

I 
I 

Address of the first user save area J 



52 

r" 



DCB 



56 

T — 



60 61 
— i- — T - 



64 



I 



96 

— T" 



100 

— T — 



104 
— I 



FQE |FP| FQE | Floating Point Registers 



J.-.—L- 



j— * 



* — Zero or Address of the first 
FQE for IBM 2361 Core Storage 



| SYNAD | Return | 
I I Area | 

-J. ... X _ J 



*-- x'Ol" Floating point registers exist 

X'02' Floating point registers do not exist 



l_ — Address of the first FQE for processor storage 



CHKPT DCB SYNAD J 



«■ Address of the CHKPT DCB 



Address of the return area for CHECKID — J 



104 
r — 



112 

— T — 



116 
— T — 



156 



CHECKID 



| Offset | 



Tape SYSOUT Information 



T 



T 



— Displacement from the beginning of the SVC 

transient area to the next sequential instruction 
for the end-of -volume (EOV) routine r IGG0551A 



— Checkpoint entry identification name 
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SVC TABLE 



Bits 

\T< 21 >f<~- 3 ~V| 

r t 1 

| Address | ESA | 

L X J 

3- byte entries for type 1 and 2 SVC routines 



Bits 

h« 5 M-*-3 ->1 

r 1 

| ESA j 

L J 

1-byte entries for type 3 and 4 SVC routines 



Bits 

h< 8 >f<- 21 >f< 3 

r t t 1 

| j ADDRESS j ESA | 
L X X J 

4- byte entries for type 1 and 2 SVC routines 



Bits 

H 10 >-H — 8 — H-< 11 — *-K— 3 

I T T T 1 

j TT | R | Length j ESA j 

L X X X J 

4-byte entries for type 3 and 4 SVC routines 
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TASK CONTROL BLOCK 

Pointed to by CVTHEAD or by TCBTCB field in next higher priority TCB. 



Offset 
-32 (-20) 

(0) 



4 

8 

12 



(4) 
(8) 
(C) 



16 (10) 



20 (14) 



28 (1C) 



29 (ID) 



Bytes and 
Bit Pattern 
30 

4 

4 

4 

4 

4 

Byte ; 



1... 
.1.. 
..1. 
.,.1 



17 (11) Bytes 1-3 : 



• • • X xxxx 



21 (15) 3 

24 (18) 1 

25 (19) 3 



30 (IE) 



1 

xxxx • • • • 

.... 0000 



Byte : 
1. 

.1 

• • XX. . 



Byte 1 : 



Field 

Name Field Description 

TCBFRS Floating point register save area. 

TCBRBP Address of the RB for executing program. 

TCBPIE Address of the Program Interrupt Element (PIE). 

TCBDEB Address of the queue of DEBs. 

TCBTIO Address of the Task I/O Table (TIOT) . 

TCBCMP Task completion code. A flag byte field containing 
indicators used or set by the ABEND SVC. 

A dump has been requested. 
Indicates step ABEND request. 

Some problem program storage was overlaid by the 
second load of ABEND. A first load overlay is indi- 
cated in TCBFLGS field. 
Reserved. 

A double ABEND has occurred. 

A dump message (WTO) is to be issued to the operator. 
Scheduler is to print an indicative dump. 
An ABEND message is provided to be printed by ABDUMP. 

System completion code in first 12 bits; user comple- 
tion code in last 12 bits. These codes are explained 
in the manual Messages and Codes . 

TCBFLTRN A byte used for flags as described: 
Reserved. 

Both TESTRAN and decimal simulator programs being 
used on a Model 91. 

Suppress taking checkpoints for this step. 
Job step TCB: This is a graphics foreground job or 
the graphic job processor. 

TCBTRN TESTRAN: Address of control core table. 

Reserved. 

TCBMSS Job Step TCB: Address of the boundary box. 
Subtask TCB: Address of last created GQE. 

TCBPKF Storage protection key for this task. 
Storage protection key. 
Must be zeros. 

TCBFLGS Flag byte fields. 



Abnormal termination in progress. 

Normal termination in progress. 

ABEND was initiated by the resident abnormal 

termination routine. 

GTF Trace has been suspended. 

Problem- program storage has been overlaid to process 

ABEND. 

Prohibit queuing of asynchronous exits for this task. 

Reserved. 



System task: ABEND prohibited for this task. 
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Offset 



Bytes and Field 
Bit Pattern Name 



30 (IE) 


..1. 


• • • • 


(cont. ) 


...1 


1.. . 






...1 




.X.. 


• XX. 


31 (IF) 


Byte 


2: 




XX. X 

..1. 


...X 




.... 


1... 




.... 


.1.. 




.... 


..1. 


32 (20) 


Byte 


3: 


33 (21) 


Byte 


4: 




.... 


...1 







:::: *i 








XXXX . . 


x. 


34 


(22) 


1 


TCBLMP 


35 


(23) 


1 


TCBDSP 


36 


(24) 


4 


TCBLLS 


ao 


(28) 


4 


TCBJLB 


44 


(2C) 


4 


TCBJSTCB 


44 


(2C) 


4 




48 


(30) 


64 


TCBGRS 


112 


(70) 


1 


TCBIDF 


113 


(71) 


3 


TCBFSA 


116 


(74) 


4 


TCBTCB 


120 


(78) 


4 


TCBTME 


124 


(7C) 


1 

00.. .. 
01.. .. 
10.. .. 

11.. .. 
..1. .. 

..0. .. 

...1 .. 


TCBPIB 



..1. 



Field Description 

Task has stopped Trace Table. 

Task has issued a system-must- complete and set all 

other tasks in the system non-di spat enable. 

Task has issued a step- must- complete and turned off 

all other tasks in the step- 

This task is a member of a time- sliced group. 

Reserved. 



Reserved bits. 

Exit Effector: System error routines already operat- 
ing for this task. 
Floating point registers exist. 
Job scheduler routines in process. 

XCTL routine is changing the storage protection key 
in the PSW from zero to that used by the problem 
program. 

Reserved. 

(If any bit in this byte is 1, the task is 
nondispatchable. ) 

Primary nondispatchability bit. This bit is set to 1 
if any of the secondary nondispatchability bits (off- 
set 173 through 175) is set to 1. This bit is set to 
if a secondary nondispatchability bit is set to 
and and all other secondary nondispatchability bits 
are 0. 

Another task is in system- must- complete status. 
Another task in this job step is in must-complete 
status . 
Reserved bits. 

Number of resources for which this task is enqueued. 

Dispatching priority for this task. 

Address of the most recently added RB on the list of 
programs loaded via the LOAD macro instruction. 

Address of a JOBLIB DCB. 

Subtask TCB: Address of Job Step TCB. 

Other TCBs: Zero. 

General register save area. 

TCB identifier field. 

Address of the first problem program save area. 

Address of next TCB of lower priority. 

Address of the timer element. 

Partition type: 
System task partition. 
Reader partition. 
Writer partition. 
Processing program partition. 
Large partition. 
Small partition. 

CPU timing stopped by FINCH until transient area is 
loaded. 

Writer partition , used by ABEND. Required by tran- 
sient writer, but used also by resident writer. 
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Offset 
124 (7C) 
(cont. ) 



125 (7D) 

128 (80) 

132 (84) 

136 (88) 

140 (8C) 

144 (90) 

148 (94) 

152 (98) 

153 (99) 



Bytes and Field 
Bit Pattern Name 



154 (9A) 



155 (9B) 



156 (9C) 

160 (A0) 

161 (Al) 
164 (A4) 

168 (A8) 

172 (AC) 



3 
4 

4 
4 



4 

1 
3 



Byte 0: 

XXXX X. . . 

Byte 1 ; 

• XXX X • • X 

Byte 2 ; 



xxx . x . xx 

4 
1 
3 
4 

4 
1 



TCBNTC 

TCBOTC 
TCBLTC 

TCBIQE 
TCBECB 

TCBXTCB 

TCBFTLMP 

TCBFTFLG 



TCBNSTAE 

TCBTCT 

TCBUSER 
TCBDAR 



Field Description 

Scheduler in control. Bit turned off when TIOT writ- 
ten on SYSJOBQE. Used by ABEND. 
Reserved bits. 

Address of the partition information block (PIB) . 

Address of the previous TCB on the originating task's 
subtask queue. The TCB for the last subtask has f s 
in this field. 

Address of the TCB for the originating task. 

Address of the last TCB on the subtask queue for this 
task. The TCB for the last subtask has in this 
field. 

Address of an interruption queue element (IQE) for 
scheduling the ETXR routine for the originating task. 

Address of the ECB that will be posted by the task 
termination routines when normal or abnormal termina- 
tion occurs. 

Reserved. 

Limit priority. 

Without Subtasking: Reserved. 
With Subtasking: Flag Bytes. 



Top task in tree of abnormally terminating tasks. 
Abnormal termination dump has been completed. 
Task in enqueued on dump data set. 
Reserved. 



OPEN in process for the dump data set. 
Dump data set is open for job step. 
SYSABEND data set. 
SYSUDUMP data set. 
Reserved. 



A valid message recursion has occurred in ABEND. 

No abnormal termination dumps can be provided within 

this job step. 

Reserved. 

Reserved. 

Flags internal to STAE routine. 

Address of the current STAE control block. 

Address of the timing control table if the system 
management facilities option is present. 

A field available to the user. 

Damage Assessment Routine (DAR) flags. 

Primary DAR recursion - DAR failure while writing 
core image dump. 

Secondary DAR recursion - DAR failure while attempt- 
ing to reinstate failing Partition. 
A dump only has been requested. 
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Bytes 


:; and 


Field 


Offset 


Bit Pattern 


Name 


172 (AC) 


.-.1 


• • • • 




(cont. ) 




1.,. 









.1.. 
...1 











173 (AD) 


3 




TCBNDSP 
TCBNDSP1 




XX, . 

1... 









.1.. 

- -XX 

.-1. 
...1 









xxxx 




17U (AE) 






TCBNDSP 2 



.XXX XXX, 



Field Description 

A recursion is permitted in CLOSE after DAR proces- 
sing is completed. 

Problem- program storage has been overlaid to execute 
DAR- 

WTO in progress for "Reinstatement Failure* message. 
SVC DUMP is executing for this task. 
Reserved bits. 

Secondary nondispatchability bits. 

If any bit in these bytes in 1, the primary nondis- 
patchability bit (byte 33, bit 7) is 1, and the task 
is nondispatchable. 
Damage assessment routine bits. 
The task is temporarily nondispatchable. 
The task is permanently nondispatchable. 
Recovery management support and system error recovery 
bits. 

The task is temporarily nondispatchable. 
The task is permanently nondispatchable. 
Reserved bits. 



ABDUMP is processing (MFT with subtasking) . 
The dump data set is being opened (MFT with 
subtasking) . 
Reserved. 



175 (AF) 



, XX xxxx 



TCBNDSP 2 



Task has been terminated (MFT with subtasking) . 

Task to be terminated by ABEND (MFT with subtasking) . 

Reserved. 



176 (BO) 
180 (B4) 



1 

.000 0001 

.000 0010 

.000 0011 

.000 0100 

.000 0101 

.000 0110 

.000 0111 

.000 1000 

.000 1001 

.000 1010 

.000 1011 

.000 1100 

.000 1101 

.000 1110 

.000 1111 

.001 0000 

.001 0001 



Reserved. 

TCBRECDE ABEND recursion reconfiguration flags. 

TCBREC Valid ABEND recursion. 

TCBOPEN OPEN of the SYSABEND or SYSUDUMP data set for the job 

step. 
TCBCLOSD CLOSE of the direct SYSOUT on tape. 
TCBCLOSE CLOSE of open data set. 
TCBCLOSF Forced close of DCBs (graphics) . 
TCBGREC Graphics (GFX) interface in control. 

Reserved. 
TCBADUMP ABDUMP in process for this task. 

Reserved. 
TCBMESG Message recursion. 

Reserved. 

Reserved. 

Reserved. 

Reserved. 
TCBTCAMR TCAM message control program reinitialization. 
TCBSAVCD Reserved. 
TCBTYP1W Invalid ABEND recursion from type-1 SVC WTP message. 



Reserved. 



.011 0011 
.011 0100 
.011 0101 



TCBTYP1R Valid return from type-1 SVC WTP message. 



.111 1111 



Reserved. 



181 (B5) 



TCBJSCB 



Address of the job step control block. 
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TIMER QUEUE ELEMENT (TQE) 



Offset 
(0) 



Bytes and 


Field 


Bit Pattern 


Name 


1 


TQEFL< 


1000 .... 




0100 .... 




0001 .... 




1000 




.... 0100 




0110 




0100 0101 





0000 



Field Description 

Flags field. 

Element is off the queue, 

LTOD requested. 

Exit specified. 

REAL request. 

SUPVSR request. 

WAIT request. 

Midnight element. 

TASK request. 

Reserved. 



1 


(1) 


3 


TQETCB 


4 


(4) 


1 




5 


(5) 


3 


TQEFLNK 


8 


(8) 


1 




9 


(9) 


3 


TQEBLNK 


12 


(C) 


4 


TQEVAL 


16 


(10) 


4 


TQELHPS1 


20 


(14) 


4 




24 


(18) 


4 


TQESAAD] 


28 


(1C) 


1 




29 


(ID) 


3 


TQEEXIT 


32 


(20) 


4 


TQEWORK 


36 


(24) 


1 

1000 0000 




36 


(24) 


64 


TQEGRS 


96 


(60) 


4 


TQEECB 


100 


(64) 


16 


TQEIQE 



Address of TCB 

Reserved. 

Address of next timer queue element. 

Reserved. 

Address of preceding timer queue element. 

Time of expiration or time remaining. 

First word of current PSW (used when TQE serves as an 
IRB). 

Reserved. 

Address of processing program save area. 

Reserved. 

Address of timer asynchronous exit routine. 

Expected TOD Clock value at expiration. 

Flags field. 
Synchronized TQE. 

Register save area when TQE is used as an IRB. 

ECB when WAIT operand is specified in STIMER macro 
instruction. 

IQE when TQE serves as IRB. 
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TIME-SLICE CONTROL ELEMENT (TSCE) 
Pointed to by CVTTSCE field. 



Offset 



Bytes and Field 
Bit Pattern Name 






(0) 


1 


1 


(1) 


3 


4 


(4) 


1 


5 


(5) 


3 


8 


(8) 


1 


9 


(9) 


3 


12 


(C) 


1 


13 


(D) 


3 



Field Description 

Dispatching priority of time-slice group. 

Address of highest-priority TCB that is a member of 
the time- slice group. 

Reserved. 

Address of the low est- priority TCB that is a member 
of the time-slice group. 

Reserved. 

Address of the next TCB to be dispatched when the 
time- slice group has the highest priority. 

Reserved. 

Length of time slice: in milliseconds before NIP; in 
timer units after NIP (26.04166 microseconds per 
timer unit) . 
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TRACE TABLE RECORD FORMAT 



NOTE: Each entry is four words 
SIO Instruction: 



Words 



(See Below) 


Channel 
Address 
Word 


1 

Channel Status Word 



First Word of SIO Entry: 
Bits 



SIO Condition Code 



3 4 







20 21 



-ih 



31 



Device 
Address 



-U- 



I/O Interruption: 
Words 1 



Bits 20-31 = 
Device Address 




Channel Status Word 



I/O Old PSW 



SVC Interruption: 
Words 1 



Bits 20-31 = 
SVC number 


Bits 8-31 = 
SVC Address 


Reg.O 


Reg. 1 



SVC Old PSW 



Task Switch 
Words 1 



Bits 16-19 = 
Task Switch 
Identifier 




New TCB address 


Old TCB address 



The addresses of the trace table are contained in a 12-byte field whose address is at hex 
loc 14. The format of the field is: 



Bytes 



Hh 



34 



Address of Current Entry 

u 



n 

Address of First Entry 

U 



78 



-N- 



Address of Last Entry 



12 



-ih 
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UNIT CONTROL MODULE (IEECUCM) 

The Unit Control Module consists of several distinct sections. These sections appear 
in main storage in the following order: 

1. UCM Prefix 

2. MCS Prefix 

3. UCM Base 

4. Event Indication List (EIL) 

5. One or more UCM Entries 

6 . Message text 

While the format remains approximately the same, the contents of the UCM depends on 
options and devices specified during system generation. The offsets given reflect a UCM 
that includes all of the options. 



UCM PREFIX 



Pointed to by UCMXECB-8 (in UCM Base) . 



Offset 
(0) 

2 (2) 

4 (4) 



Bytes and Field 
Bit Pattern Name 
2 UCM2WID 



2 
4 



UCM2RID 
UCM2PST 



Field Description 

The first 4 bytes of the UCM prefix are used in MVT 
to contain the TJID. Because TSO is not available 
with MFT, these bytes are functionally not used. 

See above. 

Address of branch entry to POST (IEA0PT01) . 



MCS PREFIX TO UCM BASE (MCS ONLY) 
Pointed to by UCMEXB-4 (in UCM Base). 



Offset 



Bytes and Field 
Bit Pattern Name 






(0) 


4 




UCMMCENT 


4 


(4) 


72 




UCMSAVEO 


76 


(4C) 


4 




UCMDOME 


80 


(50) 


4 




UCMWTOX 


84 


(54) 


2 
Byte 





UCMFLGS 






x. • • 


• • • • 


UCMSYSA 






.1.. 


• • • • 


UCMSYSB 






..1. 


• • • • 


UCMSYSC 






...1 


• • • • 


UCMSYSD 






• • • • 


1... 


UCMSYSE 






• • • • 


.1.. 


UCMSYSF 






• • • • 


-.1. 


UCMSYSG 






.... 


...1 


UCMSYSH 



Field Description 

Address of master console UCM entry. 

Resident and communications save area. 

Address of first DOM element. 

Address of WTO/R exit routine. 

Control flags: 



Reserved. 

Hardcopy support required. 

Commands to hard copy. 

Console switch for master console. 

No consoles exist. 

Graphics consoles exist. 

Hardcopy device SYSLOG. 

Timer present and operative. 
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Bytes and Field 

Offset Bit Pattern Name Field Description 
85 (55) Byte 1 

1 UCMSYSI WQE housekeeping needed. 

1 UCMSYSJ Hard copy to be done, 

.1. .... UCMSYSK New console composite. 

. . 1 .... UCMSYSL OPEN being issued to ring console alarm. 

... 1... UCMSYSM Failing console is composite. 

... .1.. UCMSYSN Graphic console present. 

1. UCMSYSO Used by WTL. 



86 


(56) 


2 


88 


(58) 


4 


92 


(5C) 


4 


96 


(60) 


1 


97 


(61) 


3 


100 


(64) 


2 


102 


(66) 


2 


104 


(68) 


4 


108 


(6C) 


4 


112 


(70) 


16 


128 


(80) 


4 


132 


(84) 


4 


136 


(88) 


4 


140 


(8C) 


4 


144 


(90) 


4 


148 


(94) 


4 


152 


(98) 


4 


156 


(9C) 


1 

1... 
.1.. 


157 


(9D) 


3 


160 


(A0) 


4 


164 


(A4) 


4 



UCMOWTOR 

UCMCMID 

UCMHCUCM 

UCMXCT 

UCMUEXIT 

UCMHRDRT 

UCMXSA 

UCM3WD 

UCMQRTN 

UCMRUTCK 

UCMDOMRT 

UCMTPPTR 

UCMNPECB 

UCMLOGAD 

UCMDTINT 

UCMSDS1 

UCMSDS1A 

UCMSDS1B 

UCMSDS2 



Default values for old WTOR macros. 

Current message ID. 

Address of hardcopy UCM entry, or zero. 

External request count. 

Address of user exit data, or zero. 

Hardcopy routing code assignments. 

Reserved. 

Address of UCM3WD (offset X^O 1 ). 

Reserved. 

Parameter list area for SVC 72. 

Address of IEECMENQ. 

Route checking field 

Address of IEECMDOM. 

Address of 2740 save area (UCMTPSAV) . 

NIP ECP; posted when NIP's hard copy can be written. 

Address of System Log TCB. 

Dynamic display time interval. 

Status display flags. 
STCMDS to hard copy. 
INCMDS to hard copy. 

Reserved. 

Address of UCM extension. 

Address of MCS prefix. 
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UNIT CONTROL MODULE (UCM) BASE 



Pointed to by CVTCUCB field. 



Offset 
-8 (-8) 


Bit Pattern 
4 


Name 


-4 


(-4) 


4 







(0) 


4 


UCMXECB 


4 


(4) 


4 


UCMAECB 


8 


(8) 


4 


UCMOECB 


12 


(C) 


4 


UCMDECB 


16 


(10) 


4 


UCMRECB 


20 


(14) 


4 


UCMLSTP 


24 


(18) 


4 


UCMWTOQ 


28 


(1C) 


4 


UCMRPYQ 


32 


(20) 


4 


UCMRPYI 


45 


(2D) 


1 


UCMRQLM 


46 


(2E) 


2 


UCMWQLM 


48 


(30) 


4 


UCMRQECB 


52 


(34) 


4 


UCMWQECB 


56 


(38) 


2 


UCMRQNR 


58 


(3A) 


2 


UCMWQNR 


60 


(3C) 


4 


UCMWQEND 


64 


(40) 


4 


UCMPXA 


68 


(44) 


1 


UCMMODE 
UCMAMFA 






:::: ::ii 


UCMOGCE 

UCMMCS 

UCMFIX 











69 


(45) 


1 


UCMCORE 


70 


(46) 


1 


UCMMODEL 


71 


(47) 


1 


UCMIMCR 


72 


(48) 


4 


UCMVEA 


76 


(4C) 


4 


UCMVEZ 


80 


(50) 


4 


UCMVEL 


84 


(54) 


56 


UCMSAVE3 


140 


(8C) 


64 


UCMSAVE4 



Field Description 
Address of UCM Prefix. 

Address of MCS Prefix. 

External interruption ECB. 

Attention interruption ECB. 

WTO/R request ECB. 

DOM request ECB. 

RMS ECB. 

Address of event indication list. 

Address of first WQE (system output queue). 

Address of the first RQE. 

Reply ID assignment pattern (100 bit positions used). 

ID limit. 

WQE buffer limit. 

Reply- request-waiting ECB. 

Buffer-request-waiting ECB. 

Current RQE count. 

Current WQE count. 

Address of last WQE or zero. 

Address of communications task TCB (IEECVTCB) . 

Mode flags. 

Accept VARY command with MSTCONS operand from any MCS 

secondary console. 

Only graphics consoles exist. 

MCS generated with system. 

MFT mode. 

MVT mode. 

WTO purge routine switches. 

System model number. 

Used by console initialization routine for error 
handling. 

Address of first UCM entry. 

Size of UCM entry. 

Address of last UCM entry. 

Save area for ED2. 

Save area for CRA. 
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Offset 



Bytes and Field 
Bit Pattern Name 



204 


(co 


4 


UCMR9SV 


208 


(DO) 


4 


UCMWEA 


212 


(D4) 


4 


UCMWEZ 


216 


(D8) 


4 


UCMWEL 


220 


(DC) 


4 


UCMREA 


224 


(E0) 


4 


UCMREZ 


228 


(E4) 


4 


UCMREL 


232 


(E8) 


232 


UCMOPENX 



Field Description 
Save area for ED2. 

Address of UCMWQE (head of WQE queue) . 

Address of UCMWSIZ (length of queue). 

Address of UCMWEND (end of WQE queue), 

Address of UCMRQE (head of RQE queue), 

Address of UCMRSIZ (length of queue). 

Address of UCMREND (end of RQE queue). 

Work area for OPEN/CLOSE. 



The following fields are included only in systems without MCS. 

464 (1D0) 144 UCMREAD Input buffer. 

608 (260) 72 UCMSAVEl Save area. 

680 (2A8) 72 UCMSAVE2 Save area. 

752 (2F0) 136 UCMINDCB Space for input DCB. 

888 (378) 116 UCMOUDCB Space for output DCB. 



UCM EVENT INDICATION LIST (EIL) 
Pointed to by UCMLSTP (in UCM Base). 

Offset 



Bytes and Field 
Bit Pattern Name 






(0) 


1 




UCMEIL 


1 


(1) 


1 




UCMRPYL 


2 


(2) 


6 






8 


(8) 


4 






12 


(C) 


4 






16 


(10) 


4 






20 


(14) 


4 






24 


(18) 


4 






28 


(1C) 


Variable 








(8- 


-128) 





Field Description 

Length in doublewords of EIL. 

Last assigned reply ID. 

Reserved. 

Address of external ECB (UCMXECB) . 

Address of attention ECB (UCMAECB) . 

Address of WTO/R ECB (UCMOECB) . 

Address of DOM ECB (UCMDECB) . 

Address of RMS ECB (UCMRECB) . 

I/O ECB addresses. This list consists of one word 
for each console device specified during system 
generation. Last entry has high-order byte set to 

x'so'. 
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UCM ENTRY INDIVIDUAL DEVICE MAP 



Pointed to by UCMVEA if first entry; by UCMVEL if last. 



Offset 



Bytes and Field 
Bit Pattern Name 






(0) 


4 




UCMECB 


4 


(4) 


4 




UCMSBR 


8 


(8) 


4 




UCMDCB 


12 


(C) 


4 




UCMUCB 


16 


(10) 


8 




UCMNAME 


24 


(18) 


1 




UCMSTS 






1... 


♦ • • • 


UCMAF 






.1.. 


• • • • 


UCMPF 






..1. 


.... 


UCMBF 






...1 


• • • • 


UCMCF 






• • • • 


1... 


UCMTA 






• • • • 


.1.. 


UCMTB 









...1 


UCMTC 


25 


(19) 


1 

1... 
.1.. 
..1. 

...1 
...0 




UCMATR 

UCMOF 

UCMIF 

UCMXF 

UCMUF 






.... 


1... 


UCMLF 






0000 


0100 


UCMAT04 



Field Description 

Address of I/O completion ECB. 

Address of resident processor module- 
Address of DCB. 
Address of UCB. 
Name of processing module. 

Status flags. 

Attention pending. 

Output pending. 

Device busy. 

Close pending. 

Open pending. 

Dequeue appropriate output queue entries. 

Working on MLWTO. 

Attribute flags. 

WTO support. 

Attention support. 

External interruption support. 

Device active. 

Device inactive. 

Load flag. 

Device status to change. 



The following fields are included 



26 


(1A) 


1 




UCMID 


27 


(IB) 


1 




UCMXA 


28 


(1C) 


4 




UCMXB 


32 


(20) 


4 




UCMRTCD 


36 


(24) 


4 




UCMOUTQ 


40 


(28) 


2 

Byte 





UCMAUTH 






1... 


• • • • 


UCMAUTH1 






.1.. 


.... 


UCMAUTH2 






..1. 





UCMAUTH3 






Byte 


1 




42 


(2A) 


2 
Byte 





UCMDISP 






1... 


• • • • 


UCMDISPA 






.1.. 


• • • • 


UCMDISPB 






..1. 


.... 


UCMDISPC 






...1 


• • • • 


UCMDISPD 






• • • • 


1... 


UCMDISPE 






• • • • 


.1.. 


UCMDISPF 






• • • • 


..1. 


UCMDISPG 






• • • • 


...1 


UCMDISPH 



with MCS only: 
Unique entry ID. 
Reserved. 
Reserved. 

Routing codes assigned to this console. 
Address of the output queue. 
Command code authorization. 



Command group 1 (SYS) . 
Command group 2 (I/O) . 
Command group 3 (CONS) , 



Reserved. 
Disposition flags. 



Master console. 

Hardcopy device/ console. 

Graphics . 

Output only. 

Console has full I/O capability. 

Console is message stream only. 

Console is status display only. 

MCS. 
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Offset 
44 (2C) 

48 (30) 

52 (34) 

56 (38) 

60 (3C) 



Bytes and Field 
Bit Pattern Name 



62 (3E) 

63 (3F) 



64 (40) 
68 (44) 



Byte 
1 

Byte 1 
1 



1 

1... . 

1.. . 

1. . 

• 1 . 

• . 1 



69 (45) 
72 (48) 



1 

JL • • • • 

1,. . 

1. . 

.1 . 

.. 1 

.. .1 

.. ..1 

3 
144 



UCMALTEN 
UCMOAOEN 
UCMWLAST 
UCMCOMPC 

UCMMSG 



UCMMSGA 
UCMMSGB 
UCMMSGC 
UCMMSGE 
UCMMSGF 



UCMXOR 

UCMDEVC 

UCMDEVA 

UCMDEVB 

UCMDEVCC 

UCMDEVD 

UCMDEVE 

UCMDEVF 

UCMDEVG 



Field Description 

Address of alternate input UCM entry. 

Address of alternate output UCM entry. 

Address of last WQE serviced on output queue. 

Address of other device if this is a composite 
console. 

Message type flags. 



Display job names requested. 
Display status requested. 
Monitor active. 
Show requested. 
Monitor SESS requested. 

Reserved. 

Reserved. 

Device control flags. 

Full screen on graphics console. 

Prepare command issued. 

Tested for console switch. 

DOM issued. 

I/O complete. 

Modified DCM for DOM. 

Halt I/O on 2740. 



UCMMLAST Address of last minor WQE serviced. 

UCMSDS5 Status display flags. 

UCMSDS5A MLWTO needed to keep writing. 

UCMSDS5B Inline output pending. 

UCMSDS5C Out-of-line output pending. 

UCMSDS5D Transient DCM blocked. 

UCMSDS5E Transient DCM locked. 

UCMSDS5F UCMMLAST field valid. 

UCMSDS5G I/O hardware in output-only status. 

UCMRCT Address of routing control table. 

UCMINPUT 



UCM MESSAGE TEXT AREA (INCLUDED WITH MCS AND USER EXIT ONLY) 
Pointed to by UCMTPPTR (in MCS Prefix). 



Field Description 
Message text. 

Routing codes. 

Descriptor codes. 

Save area for IEECMWSV interface. 



Offset 
(0) 


Bytes and 
Bit Pattern 
128 


Field 

Name 

UCMMSTXT 


128 


(80) 


4 






UCMROUTC 


132 


(84) 


4 






UCMDESCD 


136 


(88) 


72 






UCMXTSAV 


208 


(DO) 


72 






UCMTPSAV 



Save area for 2740 Device Support Processor (included 
only when 2740 is used as a system console). 
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WRITE QUEUE ELEMENT (WQE) SINGLE-LINE 



Bytes and Field 
Offset Bit Pattern Name 
(0) 1 WQEUSE 



Field Description 
Use count. 



1 (1) 3 
4 (4) 4 
8 (8) 128 



136 (88) 



137 (89) 
139 (8B) 



140 (8C) 

144 (90) 

145 (91) 
148 (94) 



150 (96) 



1 

1..- . 

.1.. . 

..1. . 



1 
1... • 

..1. . 

1 

4 

1 
3 
2 



Byte 

•••• i • • . 
Byte 1 



Byte 







Byte 1 


152 


(98) 


2 


154 


(9A) 


2 


156 


(9C) 


1 



WQELKPTR Address of next WQE. 

WQENBR Message length. 

WQETXT Message text (the message may not occupy all of the 
128 bytes) . 

WQEXA Disposition flags. 

WQEPURGE Purge. 

WQEQFHC Queue for hard copy. 

WQERQE RQE exists for this WQE. 

WQEQDFHC Queued for hard copy. 
WQE is for a WTOR. 

Reserved. 

WQEAVAIL Buffer status flags. 

WQEBUFA Buffer is free. 

WQEBUFB Buffer is in use. 

WQEBUFC Buffer is reserved. 

WQEBUFD Buffer obtained dynamically. 

WQEBUFE Buffer has been serviced. 

WQEXB Reserved. 

WQERTCT Routed WQE count. 

WQESEQN ID sequence number.^ 

WQEMCSF MCS flags. 



WQEMCSA Routing or descriptor codes exist. 

WQEMCSB UCM entry ID passed in register 0. 

WQEMCSC Command response (includes hard copy). 

WQEMCSD WQEMSGTP field in WQE to be used for message 

identification. 

WQEMCSE Accepted reply to WTOR. 

WQEMCSFF Broadcast to all active consoles. 

WQEMCSG Queue for hard copy only. 

WQEMCSH Queue to UCM entry passed in register 0. 



WQEMCSI Time stamp exists in message text. 

WQEMCSN Bypass hard copy queuing. 

WQEMCSO Reserved for DOM function. 

WEQMCSP Reserved for graphics. 



WQEMSGTP Message type flags. 



WQEMSGTA 
WQEMSGTB 



WQEROUT 



WQEUCMID 



Display jobnames . 
Display status. 

Reserved. 

Routing Codes. 

Reserved. 

Unique UCM entry ID. 
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Bytes and Field 

Offset Bit Pattern Name Field Description 

157 (9D) 1 WQEPKE TCB protection key of WTO issuer (MCS) 

158 (9E) 2 Reserved, 

160 (A0) 2 WQEDESCD Descriptor codes. 

162 (A2) 2 Reserved. 

164 (A4) 4 WQETIME Timer element. 
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WRITE QUEUE ELEMENT (WQE) MAJOR NON-MCS 



Offset 

(0) 

1 (1) 
4 (4) 



Bytes and 
Bit Pattern 
1 

3 



5 (5) 

6 (6) 
8 (8) 

80 (50) 

120 (78) 



122 (7A) 



124 (7C) 

128 (80) 

132 (84) 

136 (88) 



137 (89) 
139 (8B) 



1 
1. 



1.. . 
1. . 
.1 . 

.. 1 



1 

2 

72 

40 

2 

Byte 
1... • 

..1. . 
...1 . 

Byte 1 
2 
Byte 

Byte 1 

4 

4 

4 

1 

1 



1 



140 (8C) 



Field 

Name 

WMJUC 



WMJNXT 

WMJMLW 

WMJMLWA 

WMJMLWB 

WMJMLWC 

WMJMLWD 

WMJMLWE 

WMJMLWG 

WMJMLWH 

WMJAREA 

WMJTXTL 

WMJTXT 

WMJRES 

WMJSER 



WMJSERA 
WMJSERB 
WMJSERC 
WMJSERD 
WMJSERE 



WMJLTYP 



WMJLTYPA 
WMJLTYPB 
WMJLTYPC 
WMJLTYPD 



WMJNXTM 

WMJTCB 

WMJMSGN 

WMJMDISP 

WMJNDISPA 

WMJMDISPB 

WMJMDISPC 

WMJMDISPD 

WMJMDISPE 

WMJTJID 

WMJBUF 

WMJBUFA 

WMJBUFB 

WMJBUFD 

WMJBUFE 

WMJRORI 



Field Description 
Use count. 

Address of the next WQE, 

MLWTO flags. 

Message displayed. 

Major WQE. 

Minor WQE. 

Chain altered. 

WTL issued. 

Chain to be serviced. 

Minor queued has no text. 

Display area ID. 

Text length. 

Text of first line of message. 

Reserved. 

Existing line type. 

C Line in major. 

1 label found. 

2 LABELS FOUND. 

Last type was C line. 
Last type was L line. 

Reserved. 

Line type of message in text field. 

Control line. 
Label line. 
Data line. 
End indicator. 

Reserved. 

Address of the first minor WQE. 

Address of the TCB of task that issued WTO. 

Message ID assigned to MLWTO. 

Disposition flags. 
Purge this WQE. 
Queue for hard copy 
This WQE has an RQE. 
Queued for hard copy. 
WQE if for a WTOR. 

Terminal job ID. 

Buffer status flags. 

WQE available. 

WQE in use. 

WQE acquired by GETMAIN. 

WQE serviced. 

Reserved. 
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WRITE QUEUE ELEMENT (WQE) MAJOR MCS 



Offset 

(0) 

1 (1) 
4 (4) 



5 (5) 

6 (6) 
8 (8) 

14 (E) 

15 (F) 

19 (13) 

20 (14) 
92 (5C) 

110 (68) 



112 (70) 
120 (78) 
122 (7A) 



124 (7C) 



128 (80) 



132 (84) 



Bytes and 

Bit Pattern Name 

3 WMJMUC 



WMJMNXT 

WMJMMLW 

WMJMMLWA 
WMJMMLWB 
WMJMMLWC 
WMJMMLWD 
WMJMMLWE 
WMJMMLWF 
WMJMMLWG 
WMJMMLWH 

WMJMAREA 



1.. 
1. 



1. 
.1 



.1 
.-1 



2 

6 

1 

4 

1 

72 

18 

2 

Byte 

..1. . 
• •.1 . 
1 

8 

2 

2 



Byte 



WMJMTXTL 

WMJMTS 

WMJMPAD 

WMJMRR 

WMJMPAD1 

WMJMTXT 

WMJMRESA 

WMJSER 

WMJSERA 
WMJSERB 
WMJSERC 
WMJSERD 
WMJSERE 

WMJMCONS 

WMJMRESB 

WMJMLTYP 



WMJMLTYA 
WMJMLTYB 
WMJMLTYC 
WMJMLTYD 

WMJMMIN 



WMJMTCB 



WMJMMSGN 



Meaning 
Use count. 

Address of the next WQE. 

Flags concerning the multiple- line message repre- 
sented by the WQE: 
Entire first minor available. 
Major. 
Minor. 

Chain altered. 
WTL issued. 

(For IEECMWSV) start at top of chain. 
Chain to be serviced. 
Minor queued has no text. 

Identifier of the display area to which the display 
is to be routed. 

Length of the text field. 

Time stamp for hardcopied messages. 

Reserved. 

Routing codes for hardcopied messages. 

Reserved. 

Text of the message to be passed to the operator. 

Reserved. 

Existing line types 

C line. 

1 label found. 

2 labels found. 

Last type was C line. 
Last type was L line. 

Framing indicators (for display consoles) . 

Reserved. 

Flags indicating the line type of the line in the 
text field: 



Control line. 
Label line. 
Data line. 
End indicator. 

Address of the first minor WQE chained to the major 
WQE. 

Address of the TCB of the task that issued the 
multiple-line WTO macro instruction. 

Message number assigned to the multiple-line WTO 
message. 
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Bytes and 


Field 


Offset Bit Pattern 


Name 


136 


(88) 1 




WMJMDSP 




1... 


• • • • 


WMJMDSPA 




, 


1.. 


• • • • 


WMJMDSPB 




. 


..1. 


• • . • 


WMJMDSPC 




, 


..1 


• • • • 


WMJMDSPD 




« 


■ . « • 


1... 


WMJMDSPE 


137 


(89) 2 




WMJMTJID 


139 


(8B) 1 




WMJMBUF 




1.-. 


.... 


WMJMBUFA 




, 


1.. 


.... 


WMJMBUFB 




, 


...1 


.... 


WMJMBUFD 




■ 


.... 


1... 


WMJMBUFE 


140 


(8C) 4 




WMJMRORI 


144 


(90) 1 




WMJMRTCT 


145 


(91) 3 




WMJMSEQ 


148 


(94) 1 




WMJMCSl 




1... 


• • • • 


WMJMCS1A 






.1.. 


• • • • 


WMJMCSlB 






..1. 


• • • • 


WMJMCS1C 






.•.1 


• • • • 


WMJMCSl D 






. • • • 


1... 


WMJMCS1E 






• • • • 


.1.. 


WMJMCS1F 






■ • • . 


..1. 


WMJMCS1G 






... 


...1 


WMJMCS1H 


149 


(95) 1 


L 




WMJMCS2 




J 


L... 


• • • • 


WMJMCS2A 




, 


.1.. 


• • • • 


WMJMCS2B 






■ • • • 


.1.. 


WMJMCS2F 




, 


• • • • 


..1. 


WMJMCS2G 




• 


• • • • 


...1 


WMJMCS2H 


150 


(96) 1 


L 




WMJMMT1 




3 


L... 


.... 


WMJMMT1A 




, 


1.. 


• • • • 


WMJMMT1B 




, 


..1. 


• • • • 


WMJMMT1C 




, 


• . . a 


1... 


WMJMMT1E 




• 




.1.. 


WMJMMT1F 


151 


(97) 






WMJMMT2 


152 


(98) 






WMJMRTC 


156 


(9C) 






WMJMUID 


157 


(9D) 






WMJMTID 


160 


(A0) 






WMJMDEC 


164 


(A4) 






WMJMTIM 



Field Description 

Disposition flags with the following meanings: 

Purge the WQE. 

Queue for hardcopy. 

This WQE has an RQE. 

Queued for hardcopy. 

WQE is for WTOR. 



Reserved. 

Flags indicating the stauts of the buffer used by the 

WQE: 

Buffer space available. 

Buffer in use. 

Buffer acquired by GETMAIN. 

WQE serviced. 

Reserved. 

Routed WQE count. 

Sequence number assigned to the message. 

Flags pertaining to multiple console support (MCS) : 

Routing or descriptor codes exist. 

UCM Entry ID passed in register 0. 

Command response (hard copy) . 

WMJMMT1 field indicates message type. 

Accepted reply to WTOR. 

Queue to all active consoles. 

Queue to hard copy only. 

Queue to UCM Entry passed in register 0. 



Flags pertaining to multiple console support 

Time stamp in message text. 

WQE represents a multiple- line message. 

Bypass hardcopy queuing. 

Reserved for DOM. 

Reserved for graphics. 

Flags indicating the type of message the WQE 

represents : 

DISPLAY JOBNAMES 

DISPLAY STATUS 

MONITOR ACTIVE 

Show requested 

MONITOR SESS 

Reserved. 

Routing codes assigned to the message. 

UCM Entry ID. 

TCB key of the task that issued WTO/R. 

Descriptor codes assigned to the message. 

Timer element. 



(MCS) 
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WRITE QUEUE ELEMENT (WQE) MINOR NON-MCS 



Bytes and Field 
Offset Bit Pattern Name 
(0) 1 WMNUC 



Field Descriptions 

Use count for the minor WQE, This use count is set 
equal to the use count of the major WQE when the 
MLWTO is queued. As each console finishes with the 
line represented by the minor WQE f the use count is 
decremented by 1. When the use count equals zero, 
the WQE is ready to be removed from the system. 



1 (1) 
4 (4) 



(5) 



3 

1 

1.. 
1. 



1. . 

.1 . 
.. 1 







Byte 
1... 
.1.. 
..1. 
...1 









Byte 


1 


7 


(7) 


1 




8 


(8) 


4 




12 


(C) 


72 




84 


(54) 


52 




136 


(88) 


1... 
• 1.. 
..1. 
...1 


1 


137 


(89) 


2 




139 


(8B) 


1 








1... 
.1.. 

...1 


1 


140 


(8C) 


4 





WMNEXT Address of the next minor WQE. 

WMNMLW Flags pertaining to the message represented by the 

minor WQE: 

WMNMLWA Message displayed 

WMNMLWB Major 

WMNMLWC Minor 

WMNMLWD Chain altered 

WMNMLWE WTL issued 

WMNMLWG Chain to be serviced 

WMNMLWH Minor GETMAINed 

WMNLT Flags indicating the line type of the text field: 



WMNLTA Control line 

WMNLTB Label line 

WMNLTC Data line 

WMNLTD End indicator 

Reserved 

WMNTXL Length of the message in the text field. 

WMNHCT Hardcopy identifier. 

WMNTXT Message to be passed to the operator. 

WMNRESA Reserved. 

WMNDISP Disposition flags with the following meanings: 

WMNDISPA Purge this queue 

WMNDISPB Queue for hardcopy 

WMNDISPC This WQE has an RQE 

WMNDISPD Queued for hardcopy 

WMNDISPE This WQE is for a WTOR 

WMNTJID Reserved. 

WMNBUF Flags indicating the status of the buffer used by the 

WQE: 

WMNBUFA Buffer available 

WMNBUFB Buffer in use 

WMNBUFD Buffer acquired by GETMAIN 

WMNBUFE WQE serviced 

WMNRORI Reserved 
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WRITE QUEUE ELEMENT (WQE) MINOR MCS 



Offset 






(0) 


1 


(1) 


4 


(4) 



(5) 



Bytes and Field 

Bit Pattern Name 

1 WMNMUC1 

3 WMNMNX1 



1. .. 
1 .. 
. l a 
. .1 
. ..1 
• ...1 



WMNMML1 

WMNMML1B 
WMNMML1C 
WMNMML1D 
WMNMML1E 
WMNMML1F 
WMNMML1G 
WMNMML1H 

WMNMLT1 



Field Descriptions 

Use count for the message in the Text 1 field. 

Address of the second half of the WQE WMNMUC2) . 

Multiple- line WTO flags pertaining to the message in 

the Text 1 field: 

Major 

Minor 

Chain altered 

WTL issued 

Emergency Minor for ABEND/PURGE 

Chain to be serviced 

Minor GETMAINed 

Flags indicating the line type of the message in the 
Text 1 field: 







Byte 
1... 
.1-. 
..1. 
...1 









Byte 


1 


7 


(7) 


1 




8 


(8) 


4 




12 


(C) 


72 




84 


(54) 


1 




85 


(55) 


3 




88 


(58) 


1 




89 


(59) 


2 




91 


(5B) 


1 




92 


(5C) 


4 




96 


(60) 


72 





WMNMLT1A Control 

WMNMLT1B Label line 

WMNMLT1C Data line 

WMNMLT1D End indicator 

Reserved 

WMNMTL Length of the message in the Text 1 field. 

WMNHCT1 Hardcopy ID for the message in the Text 1 field. 

WMNMTXT1 First message to be passed to the operator by this 
WQE. 

WMNMUC2 Use count for the message in the Text 2 field. 

WMNMNX2 Address of the next minor WQE. 

WMNMML2 Multiple-line WTO flags pertaining to the message in 
the Text 2 field (see flags field at offset X f 4', 
above) , 

WMNMLT2 Flags indicating the line type of the message in the 
Text 2 field (see flags field at offset X'5 1 , above). 

WMNMTL2 Length of the message in the Text 2 field. 

WMNHCT2 Hardcopy ID for the message in Text 2 field. 

WMNMTXT2 Contains the second message to be passed to the 
operator by this WQE. 
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WTO/R MACRO EXPANSION 



Offset 
-8 (-8) 


Bytes and 
Bit Pattern 
1 


Field 
Name 


-7 (-7) 


3 






-4 (-4) 


4 






(0) 


1 






1 (1) 


1 






2 (2) 


2 








Byte 
1... 

.1.. 
..1. 
..•1 

0000 




.... 
1... 
.1.. 
..1. 
...1 
0000 






Byte 


1 






1. . . 


.... 






• • • • 


1... 








.1.. 






.... 


..1. 




4 (4) 


128 






132 (84) 


2 






134 (86) 


2 






136 (88) 


1 

1. . . 








.1.. 







137 (89) 


1 






138 (8A) 


2 







Field Description 
Length of reply. 



Address of requesters reply buffer. 

Address of requester's reply ECB. 

Reserved. 

Output message length. 

MCS Flags 



Routing and descriptor codes exist. 

UCM entry ID passed in register 0. 

Command response. 

Message type flags exist. 

This is a reply to a WTOR. 

Broadcast to all active consoles. 

Queue for hard copy only. 

Queue to UCM entry (ID passed in register 0), 

No routing or descriptor fields exist. 



Time stamp exists in message text. 
Multiple- line WTO 
Bypass hard copy queuing. 
Reserved for DOM function 

Message ID and message text. 

Descriptor codes. 

Routing codes. 

Message type flags. 
Display jobnames . 
Display status. 

Reserved. 

An SVC 35 instruction. 
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SECTION 6: DIAGNOSTIC AIDS 



This section provides the ABEND and ABDUMP entry/exit tables, and input (register con- 
tents and parameter lists) to the modules that service the macro instructions. This 
information supplements that found in the Programmer's Guide to Debugging , 



INPUT TO ABEND MODULES 



Register 1 

Option Flags (byte 1) 

ABEND Completion Code (bytes 2-4) 



REGISTER PARAMETERS 



Bytes and 
Register Bit Patterns Field Descriptions 
1 1 

1 Request is for a dump of all main storage assigned to the task. 

If a //SYSABEND DD statement is provided, all control blocks 
for the task will be displayed. 
.1 The job step of the active task is to be abnormally terminated. 

3 A completion code not greater than 4095. 
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INPUT TO THE ATTACH MODULE 



Register 1 

(when user specifies PARAM= operand, otherwise unaltered): 
Parameter List. 



Address of Optional User 



Register 15 

ATTLIST (Address of ATTACH Parameter List) 



ATTACH Parameter List 



Offset 
(0) 



(1) 



(4) 



(5) 



8 (8) 

9 (9) 

12 (C) 



Bytes and 

Bit Patterns 

1 

0000 0000 

1000 0000 



0000 0000 
0000 0001 
0000 0010 



Field 

Name 

ATTDE 



ATTEP 



ATTHI 



ATTDCB 



1 
3 



0000 0000 
0000 0001 



ATTECB 



ATTGSLI 



Field Descriptions 

EP or EPLOC specified. 
DE specified. 

For EP or EPLOC: address of symbolic entry point 

name . 

For DE: address of the directory entry. 

No hierarchy was specified. 
Hierarchy zero was specified. 
Hierarchy one was specified. 

Address of the DCB for the PDS containing the entry 
point name. An address of zero indicates that the 
JOBLIB or LINKLIB DCB is to be used. If the operand 
is omitted, zero is used. 

Reserved. 

Address of the ECB to be used by the control program 
to indicate the termination of the new task. The 
return code or completion code will also be placed in 
the ECB. 

Bytes 13-15 contain a subpool number. 

Bytes 13-15 contain the address of a list of subpool 

numbers . 



13 (D) 



16 (10) 



17 (11) 



20 (14) 

21 (15) 



0000 0000 
0000 0001 



ATTGSLV 



ATTSSLI 



ATTSSLV 



1 
3 



ATTETXR 



A subpool number, or the address of a list. The 
subpool (s) specified are assigned to the new task and 
can no longer be used by the originating task. If 
list is specified, the first byte of the list con- 
tains the number of remaining bytes in the list. 

Bytes 17-19 contain a subpool number. 

Bytes 17-19 contain a list of subpool numbers. 

A subpool number or the address of a list of subpool 
numbers. The subpool (s) may be shared by the new 
task and the originating task. If list is specified, 
the first byte of the list contains the number of 
remaining bytes in the list. 

Reserved. 

Address of the end-of-task exit routine to be given 
control when the new task terminates. 
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Bytes and Field 
Offset Bit Patterns Name 
24 (18) 2 ATTDPMOD 



Field Descriptions 

The signed number to be algebraically added to the 
current dispatching priority of the originating task. 
The result is assigned as the dispatching priority of 
the new task, unless it is greater than limit priori- 
ty of the new task, in which case the limit priority 
of the new task is assigned as the dispatching 
priority. If the field is r the smaller of the new 
task's limit priority and the dispatching priority of 
the originating task is assigned. 



26 (1A) 



21 (IB) 



1 

.0., 
.1., 



..0. 



...0 







...1 


.... 








.... 


0... 








.... 


1... 
.0.. 











.1.. 
. .0. 








.... 


..1. 










...0 

...1 




28 


(1C) 


8 




ATT NAME 


36 


(24) 


1 







37 (25) 



ATTLPMOD The number to be subtracted from the limit priority 
of the originating task. The result is assigned as 
the limit priority of the new task. If the field is 
zero, the limit priority of the originating task is 
assigned. 

ATTKEYS 

Reserved. 

Propagate the JSCB field from the originating TCB. 

If the originating task's protect key is zero, move 

the specified JSCB address (see byte 37) into the 

attached TCB. Otherwise, propagate the originating 

task's TCBJSCB field. 

Subpools 251 and 252 and the job pack queue pointer 

(TCBJPQ) of the originating task are not to be given 

to the attached subtask. 

Subpools 251 and 252 and the job pack queue pointer 

(TCBJPQ) of the originating task are to be given to 

the attached subtask. 

The attached task is to have a protect key equal to 

that of the originating task. 

The attached task is to have a protect key of zero. 

Subpool zero is to be shared with other tasks. 

Subpool zero is not to be shared. 

A save area of 72 bytes is to be obtained for the 

task. 

No save area is to be obtained. 

Propagate the TCBJSTCB field from the originating 

task. 

The TCBJSTCB of the new task is to point to the new 

task. 

The new task is to operate in problem-program mode. 

The new task is to operate in supervisor mode. 

The entry point name if EP was specified. This field 
contains blanks if EPLOC or DE was specified. 

Reserved. (This field is present only when the JSCB 
operand is specified.) 

ATTJSCB Address of the job step control block. 



Optional User Parameter List 
Offset 



(0) 
4 (4) 
n 

n+1 



Bytes and Field 
Bit Pattern Name 



4 

4 

1 
1. 



Field Description 

First address parameter. 

Second address parameter. 



This is the last entry in the list. 
Last address parameter. 
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INPUT TO THE CHAP MODULE 



Register 

CHAPVAL, Dispatching Priority Change Value 



Register 1 

CHAPARM, Zero or Address of user parameter list which contains address of TCB. 



Register Contents 



Register 




Bytes and 
Alignment 
1 

0000 0000 

0001 0001 



Field Description 

A positive value was specified. 

A negative value was specified. Register contains the comple- 
ment of the absolute value of the negative number. 

The value to be added to the tasks Dispatching Priority. 



INPUT TO THE DELETE MODULE 

Register 

DELADDR, Address of DELETE parameter list. 



DELETE Parameter List (Created by User) 



Delete Parameter List 



Offset 
(0) 



Bytes and 
Bit Pattern 



Field 

Name 

DELNAME 



Field Description 

The eight byte entry point name of module to be 
deleted. The field must be padded with blanks if the 
name is less than eight characters in length. 
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INPUT TO THE DEQ MODULE 

Register 1 

DEQLIST r Address of DEQ Parameter List 

DEQ Parameter List 

(generated by the ENQ macro instruction) The DEQ Parameter List may be extended in 
multiples of 3 or 4 words (because of parameter field ADUCB) . 





Bytes and 


Field 


Offset 


Bit Pattern 


Name 


(0) 


1 

1111 1111 


LISTEND 


1 (1) 


1 


LMINOR 


2 (2) 


1 



.0.. 0... 
.0., 1... 
.1.. 0... 

•1.. 1... 

..1 

.,.1 

000 


PARMCDS 



3 (3) 



,001 



4 


(4) 


1 


5 


(5) 


3 


8 


(8) 


1 


9 


(9) 


3 


n 


(n) 


1 

3 



RETURN 



ADMAJOR 



ADMINOR 



ADUCB 



Field Description 

This is the last entry in the list. 

The length, in bytes, of the Minor Resource Name. 



Set to zero with a DEQ request. 

The request is for a resource of this job step. 

The request is for a reserved resource. 

The request is for a resource known to the system. 

The request is for a resource known across systems. 

"Reset System Must Complete" is requested. 

"Reset Step Must Complete" is requested. 

This is an unconditional request to release the 

resource. The task will be abnormally terminated if 

it has not been assigned the resource. 

This is a conditional request to release the resource 

only if it has been assigned to the task. 

This field is used by the control program to return 
the return code for conditional requests. 

Reserved. 

The address of an 8-byte field containing the Major 
Resource Name. 

Reserved. 

The address of an 1-255 byte field containing the 
Minor Resource Name. 

Reserved. (This field is only present when a 
reserved resource is to be dequeued.) 
The address of a word containing the UCB address for 
the device to be dequeued. (This field is only pre- 
sent when a reserved device is to be dequeued.) 
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INPUT TO THE DOM MODULE 

Register 

DOMFLG, DOM Message or Message List Indicator 

Register 1 

DOMMSG f DOM Message Identification Number or Address of Optional User Parameter List 

Optional User Parameter List 



Dec Hex 
r - 



First Message Identification 
Number 



4 |. 



Second Message Identification 
Number 



F „ 

I 

»T T 

| Last Entry | 
| Indicator | 

L J._ 



Last Message Identification 
Number 



Register Parameters 



Register 




Bytes and 
Bit Pattern 
1 



Field Descriptions 

Indicates that a list of identification numbers has been 

specified. 

Indicates that only one identification number has been specified 

(register 1) . 

Address of a list of identification numbers; or a 24-bit right- 
adjusted identification number of the message to be deleted. 



Parameter List 



Offset 
(0) 



Bytes and 
Bit Pattern 



Field Description 

24-bit, right- ad jus ted identification number of the message to 

be deleted. 



n (n) 1 



Indicates last message in the list. 
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INPUT TO THE ENQ MODULE', 

Register 1 

ENQLIST, Address of ENQ Parameter List 



ENQ Parameter List 

Offset 
(0) 



Bytes and 
Bit Pattern 



1 
2 



(1) 
(2) 



1111 1111 

1 
1 



Field 

Name 

LISTEND 



LMINOR 
PARMCDS 



1... 

.0., 
.1.. 
.1.. 



.1. • 

..1 . 

. .. .111 

. .. .110 



.011 
.001 
.000 



(3) 



4 


(4) 


1 


5 


(5) 


3 


8 


(8) 


1 


9 


(9) 


3 



RETURN 



ADMAJOR 



ADMINOR 



Field Description 

This is the last entry in the list. 

The length, in bytes, of the Minor Resource Name. 



This request is for exclusive control of the 
resource. 

This request is for shared control of the resource. 
The resource is used only by this job step. 
The resource may be used by more than one job step. 
The request is for a resource known across systems. 
"Set System Must Complete" is requested. 
"Set Step Must Complete" is requested. 
The request is for the availability status of the 
resource (s), but not actual control. 
The request is to change the attribute of the 
resource from shared to exclusive, only if the requ- 
ester can have immediate exclusive control (requester 
is already enqueued for the resource) . 
Control of the resource (s) is requested only if the 
task can have immediate control of it. 
Control of the resource (s) is requested only if the 
task has not previously requested it. 
This is for an unconditional request for the 
resources. If any of them are not available, the 
task is put into a wait state until they are 
available. 

This field is used by the control program to return 
the return codes for conditional requests. 

Reserved. 

The address of an 8-byte field containing the Major 
Resource Name of the resource requested. 

Reserved. 

The address of an 1-255 byte field containing the 
Minor Resource Name of the resource requested. 
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INPUT TO THE EXTRACT MODULE 

Register 1 

EXTRPRM, Address of EXTRACT Parameter List. 



EXTRACT Parameter List 



Offset 
(0) 



4 (4) 



Bytes and Field 

Bit Pattern Name 

4 EXTRLST 



EXTRTCB 



8 (8) 1 



« . . jl • 

• • • • JL 



.1.. 

..1. 
...1 



EXTRFLG 



9 (9) 3 



Field Descriptions 

Address of the user's answer area in which the 

extracted fields are placed. 

Address of the TCB from which the fields are to be 
extracted. A zero in this field indicates that the 
current TCB is the subject. 

Flags indicating which TCB fields are to be 
extracted. 

GRS — Address of the general register save area. 
FRS — Address of the floating point register save 
area. 

TAX — Contents of TCB+148 (X^ 1 ); this is presently 
reserved. 

AETX — Address of the end-of-task exit routine spec- 
ified in the ATTACH macro instruction. 
PRI — Limit and dispatching priorities of the task; 
these will be placed in the last two bytes of the 
answer area. 

CMC — Task completion code; zero if task is not 
complete. 

TIOT — Address of the Task I/O Table. 
COMM — Address of Communications Parameter Area. 

Reserved. 
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INPUT TO FREEMAIN MODULE 



Register Type Request 

Register 

FRESP, Number of the Subpool from which Area is to be Freed (1 byte), 
FRELNGTH, Number of Bytes to be Freed (3 bytes). 

Register 1 

FREAD, The beginning address of the area to be freed. 



Element and Variable Type Reguest 

Register 1 

FREPARM, Address of FREEMAIN Parameter List. 



FREEMAIN Parameter List 



Offset 



(0) 
(1) 

U) 
(5) 



8 (8) 



Bytes and 
Bit Pattern 
1 

3 



1 
3 

1 

0000 0000 



Field 
Name 



FRELNGTH 



FREADD 



FRETYPE 



(9) 



FRESPID 



Field Descriptions 
Reserved. 

Zero indicates a variable type request. For element 
type requests , this is the length to be freed. 

Reserved. 

The address of a list containing the beginning 
addresses of the area(s) to be freed. The high order 
bit in the last fullword in the list is set to 1. 

Indicates a request for the release of a single area 

of storage. 

Indicates a request for the release of one or more 

areas of storage. 

Indicates a variable type request for the release of 

one area of storage. The address and the length are 

in the length list. 

The number of the subpool from which the storage is 
to be freed. 
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INPUT TO GETMAIN MODULE 



Register Type Request 



Register 

GETSP, Subpool Number (byte 1). 
GETLNGTH, Length Reguested (bytes 2-4), 



Register 1 

GETID, Negative to indicate GETMAIN reguest. 



Element and Variable Type Request 

Register 1 

GETPARM, Address of GETMAIN Parameter List. 



GETMAIN Parameter List 



Offset 



(0) 
(1) 



Bytes and 
Bit Pattern 

1 

3 



Field 
Name 



GETLNGTH 



Field Descriptions 
Reserved. 

For element reguests, this is the length in bytes of 
the amount of storage reguested. For list and vari- 
able reguests, it is the address of a list of 
reguested lengths. The high order bit of the last 
word is set to one to indicate the end of the list. 



4 (4) 



GETHID The Hierarchy from which the storage is to be 
obtained. 



5 


(5) 


3 




8 


(8) 


1 








0010 


0000 






0000 


0000 






1010 


0000 






1000 


0000 






1110 


0000 






1100 


0000 



9 (9) 



GET ADD 



GETYPE 



GETSP ID 



Reserved. 



Conditional single element reguest. 
Unconditional single element reguest. 
Conditional list reguest. 
Unconditional list reguest. 
Conditional variable reguest. 
Unconditional variable reguest. 

The number of the subpool from which the reguested 
core is to be allocated. 



Length Parameter List 



Offset 
(0) 


Bytes and 
Bit Pattern 
1 


Field 
Name 


1 (1) 


3 


GETLNG1 


4 (4) 






5 (5) 


3 


GETLNG2 



n (n) 



1000 0000 



Field Descriptions 
Reserved. 

The length, in bytes, of the main storage reguested. 
For a variable reguest, this field contains the mini- 
mum storage reguested. 

Reserved. 

The length, in bytes, of the next area of main 
storage reguested. For a variable reguest, this is 
the maximum amount of storage reguested. 



This indicates that this is the last word in the 
list. 
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User Supplied Address List 



Offset 
(0) 


Bytes 
1 


1 (1) 


3 


4 (4) 




5 (5) 


3 



Field 
Name 



GETADD1 



GETADD2 



Field Descriptions 
Reserved. 

GETMAIN is to return the address of the first area 
allocated in this field. 

Reserved. 

For a variable request, it is used to return the 
length of the area allocated. 



INPUT TO IDENTIFY MODULE 



Register 

IDEP, Address of Entry Point Symbolic Name. 



Register 1 

IDENTRY, Main Storage Address of the Entry Point Being Added. 

Entry Point Symbolic Name 

(supplied by user [EPLOC=], or generated by macro [EP=]) 



Offset 
(0) 



Bytes 
8 



Field 

Name 

IDNAME 



Field Descriptions 

The eight- byte symbolic entry point name to be added 
to the module. The name may be padded with blanks, 
if necessary. 
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INPUT TO LINK MODULE 

Register 1 

LINPARM, Address of Optional User Parameter List. 

Register 15 

LINKPARM, Address of LINK Parameter List. 



User Optional Parameter List 



Bytes and Field 
Offset Bit Pattern Name 

(0) 1 

1 (1) 3 
n (n) 1 



Field Descriptions 

Reserved. 

The first user-supplied address parameter. 



n+1 (n+1) 3 



VL=1 specified. This indicates that this is the last 

word in the parameter list. 

The last user- supplied address parameter. 



LINK Parameter List 



Offset 
(0) 



Bytes and 

Bit Pattern 

1 

0000 0000 

1000 0000 



Field 

Name 

LINKFLG 



Field Descriptions 

EP or EPLOC forms specified. 
DE form specified. 



(1) 



LINKEP For the EP or EPLOC forms, this field contains the 

address of a doubleword containing the symbolic entry 
point name for the called routine. 

For the DE form, this field contains the address of 
the DE list entry. 



<4) 



(5) 



0000 0000 
0000 0001 
0000 0010 



LINKHI 



LINKDCB 



No hierarchy was specified. 
Hierarchy zero was specified. 
Hierarchy one was specified. 

The address of the specified DCB. Zero indicates 
that the DCB address was not specified. The JOBLIB 
and LINKLIB DCBs will be assumed. 



Symbolic Name 



Offset 
(0) 



Bytes and 
Bit Pattern 



Field 

Name 

LINKNAME 



Field Descriptions 

This field contains the symbolic entry point name of 
the called routine. If the name is less than 8 
characters in length, it is padded with blanks. 
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INPUT TO LOAD MODULE 

Register 

LOADDE, Directory Entry Indicator (byte 1). 

LOADEP, Address of Symbolic Entry Point Name; or Two f s Complement of Address (bytes 

2-4). 



Register 1 



LOADHI f Hierarchy Indicator (byte 1) , 
LOADDCB, Address of DCB (bytes 2-4). 



Register Parameters 



Register 




Bytes and 

Bit Pattern 

1 

0000 0000 

1111 1111 

3 



Field Descriptions 

The EP= or EPLOC= operands were specified. 

The DE= operand was specified. 

If EP= or EPLOC= was specified , this field contains the address 

of the Symbolic Entry Point Name. If the name is less than 8 

characters in length, it is padded with blanks. 

If DE= was specified, this field contains the two's complement 
form of the address of the directory entry. (Note: The LOAD 
service routine (SVC 8) converts the DE address back to a posi- 
tive format . ) 



0000 0000 No hierarchy was specified. 
0000 0001 Hierarchy zero was specified. 
0000 0010 Hierarchy one was specified. 

3 Address of the DCB. Zero indicates that the JOBLIB or LINKLIB 

DCB is to be used. 

Symbolic Entry Point Name 

(supplied by user [EPLOC= or DE=], or by Macro £EP=]) 



Bytes and Field 
Offset Bit Pattern Name 
(0) 8 LOADNAM 



Field Descriptions 

This field contains the symbolic entry point name of 
the called routine. If the name is less than eight 
characters in length, the field is padded with 
blanks . 
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INPUT TO THE POST MODULE 

Register 

POSTCDE, Code to be Posted in the ECB. 

Register 1 

POSTECB, if high- order bit is on, points to an address in main storage that contains 
the address of an ECB. 

Register 11 

address of ECB on branch entry to POST. 



INPUT TO THE RETURN MODULE 



Register Contents 

Register Bytes 
13 4 



Field Descriptions 

Address of the save area in which registers were previously 

saved. 



14 



15 



Address in the calling program to which control is to be 

returned. This register must be loaded by the user if register 

14 is not within the range of registers specified to be restored 
by the macro. 

Return code if the RC=number operand is not used. Use of the 

RC=(15) operand will override a reguest to restore register 15 
from the save area. 



INPUT TO SAVE MODULE 



Register 13 (user-supplied) 

SAVADDR, Address of Save Area. 

Register 15 

MODIDAD, Address of SAVE Macro Instruction, 
tifier which is created at SAVE+4. 



This is used to locate the module iden- 



Module Identifier Parameter List 



Offset 


1 



Bytes 
1 



Field 

Name 

SAVCNT 

SAVID 



Field Descriptions 

Length, in bytes, of the identifier name. 

The name given by the user as the identify operand in 
the macro. This may be 1 to 70 characters long. 



446 



INPUT TO SNAP MODULE 

Register 1 

SNAPARM, Address of SNAP Parameter List 

SNAP Parameter List 



Offset 

(0) 

1 (1) 

2 (2) 



(3) 



4 (4) 

5 (5) 

8 (8) 

9 (9) 

12 (C) 

13 (D) 



Bytes and Field 
Bit Pattern Name 
1 SNAPID 



1 
1. 



SNAPFLG1 



0.. 

1.. 

0. 

1. 



1 



. 

. 1 



.0 

.1 



.0 

.1 



SNAPFLG2 



0. 
1. 



0. 
1. 



1 





1 

.0 

.1 



.0 

.1 



Field Descriptions 

ID number to be printed in the identification heading 

of the dump. 

Reserved. 



Always set to one by Snap macro. 

Dump is for active task. 

Dump is for specified subtask. 

Do not include the control blocks in the dump. 

Include the control blocks in the dump. 

Do not include the trace table in the dump. 

Include the trace table in the dump. 

Do not include the nucleus. 

Include all the nucleus except the trace table. 

No list of addresses was supplied. 

A list of addresses specifying the storage areas to 

be dumped has been supplied. 

No ID number was specified. 

An ID number is to be printed in the dump. 

No queue control blocks or queue elements are to be 

printed. 

The queue control blocks and queue elements are to be 

printed. 

Do not provide a back trace of the save areas. 

Provide linkage information and a back trace of the 

save areas. 

SAH not specified. 

SAH specified; provide linkage information. 

Do not provide register contents. 

Provide the contents of the general registers at the 

time that the SNAP was issued. 

Do not provide LPA information. 

Provide the contents of the Link Pack Area. 

Do not provide JPA information. 

Provide the contents of the Job Pack Area. 

Do not provide the PSW. 

Provide the Program Status Word at the time that the 

SNAP was issued. 

Do not supply the subpools. 

Provide all subpools (0-127) . 

Always set to 0. 

Reserved. 

SNAPDCB The address of the DCB for the data set to contain 
the dump. 

Reserved. 

SNAPTCB Zero indicates dump is for the active task. Other- 
wise address of the TCB for which the dump is to be 
taken . 

Reserved. 

SNAPSTOR Zero indicates no addresses were specified for the 
areas to be dumped. Otherwise, address of the 
storage parameter list containing the starting and 
ending addresses of the areas to be dumped. 
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INPUT TO SPIE MODULE 



Reqister 1 

SPIADD, Address of 


PICA. 


PICA Parameter List 




Offset 
(0) 


Bytes and 
Bit Pattern 
1 


Field 

Name 

SPIMSK 


1 (1) 


3 


SPIEXIT 


4 (4) 


2 


SPINT 



Field Descriptions 
Program Mask. 

The address of the user-specified exit routine. 

Program interruption mask. 



INPUT TO STAE MODULE 

Reqister 

STAEOPT, Create/Overlay Option Indicator. 

Reqister 1 

STAEXTL f XCTL Indicator (byte 1). 

STAELST r Address of STAE Parameter List (bytes 2-4), 



Reqister Parameters 



Reqister 




Bytes and 

Bit Pattern 

1 

0000 0000 

0000 0100 

0000 1000 



0000 0000 

1000 0000 
3 



Field Description 

Create/Overlay Indicator. 

A new STAE parameter list is to be created. 

Cancel the most recent STAE request. 

Overlay the previous STAE parameter list with the parameters 

passed in this request. 

XCTL indicator. 

Indicates that the STAE macro instruction is to be canceled if 

an XCTL is issued by this program. If the XCTL operand is not 

specified, this option is assumed. 

Indicates that the STAE macro instruction is not to be canceled 

if an XCTL is issued by this program. 

The address of the STAE parameter list. 



STAE Parameter List 



Offset 
(0) 

4 (4) 



Bytes and 
Bit Pattern 
4 

4 



Field 

Name 

STAEXIT 



STAEPRM 



Field Description 

Address of STAE exit routine. 

Address of parameter list to be passed to STAE exit 
routine. 
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INPUT TO STIMER MODULE 

Register 

STIFLG (byte 1) . 

STIEXIT, Address of Exit Routine (bytes 2-4) 

Register 1 

STIVAL, Address of STIMER Parameter List. 



Register Parameters 



Register 




Bytes and 
Bit Pattern 
1 
0000 

0001 .... 

0011 

0111 

.... 0000 
0001 

.... 0011 



1 

3 



Field Descriptions 

TUINTVL specified - the time interval is specified in timer 

units. 

BINTVL specified - the time interval is specified as a binary 

number. 

DINTVL specified - the time interval is specified as a decimal 

number. 

TOD specified - the time of day is specified in the form 

HHMMSSth. 

The interval is to be decremented only when the task is active. 

The interval is to be decremented continuously and the current 

task is to be placed in a wait condition until the interval 

expires. 

The interval is to be decremented continuously. 

The address of a user exit routine to be given control when the 
time interval expires. Zero indicates that no exit address was 
specified. 

Reserved. 

For DINTVL and TOD, this is the address of a doubleword contain- 
ing the time value. 

For BINTVL and TUINTVL this is the address of a fullword con- 
taining the time interval. 



STIMER Parameter List (depends on BINTVL, TUINTVL, DINTVL, or TOD operand specified) 



Offset 
(0) 



Bytes and 
Bit Pattern 



Field 

Name 

STIMTU 



Field Descriptions 

Contains the time interval as an unsigned 32-bit 
binary number where the low- order bit represents one 
timer unit (26. 04 microseconds). 



(0) 



STIMBIN Contains the time interval as an unsigned 32-bit 

binary number where the low-order bit represents 0.01 
seconds. 



(0) 



STIMDEC Contains the time interval as unpacked decimal digits 
in the form HHMMSSth where : 



HH is hours. 

MM is minutes 

SS is seconds 

t is tenths of seconds 

h is hundredths of seconds. 



(0) 



STIMTOD Contains the time of day when the interval is to be 
completed. The interval is specified as unpacked 
decimal digits in the form HHMMSSth. 
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INPUT TO TIME MODULE 

Register 1 

TIMUNIT f Type of Unit Requested. 



Register Parameters 



Register 


Bytes and 
Bit Pattern 


1 


3 




1 

0000 0000 




0000 0001 




0000 0010 



Field Descriptions 
Reserved. 



The time of day is to be returned in register as an unsigned 
32-bit binary number. (The least significant bit represents 
26.04 microseconds.) 

The time of day is to be returned as an unsigned 32-bit binary 
number. (The least significant digit represents 0.01 seconds.) 
The time is to be returned as packed decimal digits in the form 
HHMMSSth where: 



HH is hours 

MM is minutes 

SS is seconds 

t is tenths of seconds 

h is hundredths of seconds. 



INPUT TO TTIMER MODULE 

Register 1 

TTICODE, Type of Request. 



Register Parameters 
Bytes and 



Register 
1 



Bit Pattern 

3 

1 

0000 0000 

0000 0001 
0000 0010 



Field Descriptions 
Reserved. 

The time remaining in the current task's time interval is to be 
returned in register (the interval is not to be canceled) . 
The current task's time interval is to be canceled. 
The time interval of a related task is to be canceled. 
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INPUT TO WAIT MODULE 

Register 

WAITYP, Wait Indicator (bytes 1-3) . 
WAITNUM, Number of Events (byte 4). 

Register 1 

WAITFLG, Element/List Indicator (byte 1) . 
WAITECB, Address of ECB or ECB List (bytes 2-U) . 

Register Parameters 

Bytes and 
Register Bit Pattern Field Descriptions 

3 Zero indicates the Wait Macro was used. 

1 The number of events which are to be awaited. This number must 

be less than 256. 

1 1 

0000 0000 One ECB has been specified. 

0000 0001 A list of ECBs has been specified. 

3 The address of an ECB or a list of ECB addresses. (If a list is 

specified 9 the address is in complemented form. The high-order 
bit of the last entry must be set to one.) 
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INPUT TO WTO MODULE 

Register 

(used only when QREGO is specified in MCSFLAG operand) 
UCMID, Console ID. 



Register 1 

WTOPRM, Address of WTO Parameter List, 



WTO Parameter List 



Offset 
(0) 

2 (2) 



Bytes and 
Bit Pattern 
2 

2 



Field 

Name 

WTOLNG 



WTOMCSF 



Field Descriptions 

The length, in bytes , of the WTO message + 4. 

MCS Codes. 



(3) 



(4) 



Byte ; 



.1.. 

..1. 

...1 



Byte 1 ; 

• XXX X. • • 

• . • . • • X.X. 

Variable 



WTOMSG 



WTODESC 



The WTODESC and WTOROUT fields do not exist. 

The WTODESC and WTOROUT fields exist. 

The message is to be gueued to the console whose 

source ID is passed in Register 0. 

The WTO is an immediate command response. 

Indicates that the WTOMSGT field exists. 

The WTO macro instruction is a reply to a WTOR macro 

instruction. 

This message should be broadcast to all active 

consoles. 

This message is to be gueued for hard copy only. 

This message is to be gueued unconditionally to the 

console whose source ID is passed in register 0. 



Time is not appended to the message. 

Reserved. 

This message is not to be gueued for hard copy 

(ignored if issuer does not have a zero protect key), 

Reserved. 

WTO message to be written on operator's console or 
WTP message for programmer. 



Descriptor Codes. 



Byte 


0: 


1... 





.1.. 
..1. 
...1 


1... 


.... 


.1.. 
..1. 






System Failure - another IPL of the system is 
reguired. 

Immediate operator action reguired. 
Eventual action reguired. 

System Status is indicated by the message. 
Immediate command response - for error and nonerror 
messages that are written as a result of an operator 
or system command. 

Job Status indicated by the message. 
Application Program/Processor - for messages issued 
by problem programs and processors executed as pro- 
blem programs. 
Operator reguest for status information. 



n+1 



n+2 



Byte 1: 
.XXX xxxx 




Out-of-line message 
Reserved. 


2 


WTOROUT 


Routing codes. 



452 



Offset 



n+4 



Bytes and 


Field 


Bit Pattern 


Name 


Byte 


0: 




1... 


• • • • 




.1.. 


• • • • 




..1. 


• • • • 




.-.1 


• • • • 




• • • • 


1... 




• • • • 


.1.. 




• • • • 


..1. 







...1 




Byte 


1: 




1... 


• • • • 




.1.. 


• • • • 




-.1. 


• • • • 




...1 


.... 




• • • • 


XXX, 







. . .X 




1 




WTOMSGT 


Byte 


0: 




1. . . 


.... 




• 1.. 
..1. 

• . «x 


.... 




xxxx 





Field Descriptions 

Master Console. 

Master Console Informational. 

Tape Pool Console. 

Direct Access Pool Console. 

Tape Library Pool Console. 

Disk Library Pool Console. 

Unit Record Pool Console. 

Teleprocessing Control. 



System Security. 

System Error/Maintenance. 

Programmer Information Console. 

Reserved. 

User Routing Codes. 

Reserved. 

Message Type Flags. 



Display Jobnames . 
Display Status. 
Monitor Active. 
Reserved. 



Section 6: Diagnostic Aids 453 



INPUT TO MULTIPLE- LINE WTO 

Register 

(used only when QREGO is specified in MCS FLAG operand) . 

Register 1 

WTOPRM, address of the WTO parameter list. 



UCMID, console identifier. 



MLWTO Parameter List 



Offset 
(0) 


Bytes and 
Bit Pattern 
1 byte 


Field 

Name 
WTOMKl 


1 


(1) 


1 byte 


WTOLNT1 


2 


(2) 


2 

Byte 
0. .. 
1... 
.1.. 

..1. 
...1 




1111 
1... 

.1.. 

..1. 
...1 


WTOMCSF 


3 


(3) 


Byte 
1... 

.XXX 


1 

• .XX 




i* 


(4) 


VARIABLE 


WTOTXT1 



Field Description 

Marker designating start of the first field of the 

multiple-line WTO. 

The length, in bytes , of WTOTXT1 + 4. 

MCS codes. 



The WTODESC and WTOROUT fields do not exist. 

The WTODESC and WTOROUT fields exist. 

The message is to be queued to the console whose 

source ID is passed in register 0. 

The WTO is an immediate command response. 

Indicates that the WTOMSGT field exists. 

The WTO macro instruction is a reply to a WTOR macro 

instruction. 

This message should be broadcast to all active 

consoles. 

This message is to be queued for hard copy only. 

This message is to be queued unconditionally to the 

console whose source ID is passed in register 0. 



Time is not appended to the message. 

Reserved. 

This message is not to be queued for hard copy 

(ignored if user does not have a zero protect key) , 

Reserved. 

Text of the first line of the multiple-line WTO 
message. 



n+ 4 



WTODESC 



Descriptor Codes. 



n+5 



Byte 







1... 
.1.. 






..1. 
...1 


1. 


•- 



.1. 



.X 



Byte 1 
.xxx xxxx 



System Failure - another IPL of the system is 

required. 

Immediate operator action required. 

Eventual action required. 

System Status is indicated by the message. 

Immediate command response - for error and nonerror 

messages that are written as a result of an operator 

or system command. 

Job Status indicated by the message. 

Application Programmer/Processor - for messages 

issued by problem programs and processors executed as 

problem programs . 

Operator's request for status information. 



Out-of-line message. 
Reserved. 
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Offset 
n+6 


Bytes and 
Bit Pattern 
2 

Byte 

..1 

...1 

... 1 

Byte 1 


Field 

Name 

WTOROUT 








1 






.... XXX . 






X 




n+8 


1 

Byte 
1 


WTOMSGT 


n+10 


2 bytes 


WTOLT1 


n+12 


1 byte 


WTO AID 


n+13 


1 byte 


WTOLCT 


n+14 


1 byte 


WTOMK2 


n+15 


1 byte 


WTOLNT2 


n+16 


2 bytes 


WTOLT2 


n+18 


Variable 


WTOTXT2 




1 byte 


WTOMK3 




1 byte 


WTOLNT3 




2 bytes 


WTOLT3 




Variable 


WTOTXT3 



Field Description 
Routing codes. 



Master Console. 

Master Console Informational. 

Tape Pool Console. 

Direct Access Pool Console. 

Tape Library Pool Console. 

Disk Library Pool Console. 
Unit Record Pool Console. 
Teleprocessing Control. 



System Security. 

System Error/Maintenance. 

Programmer Information Console. 

Reserved. 

User Routing Codes. 

Reserved. 

Message Type Flags: 



Display Jobnames. 
Display Status. 
Monitor Active. 
Reserved. 

Line type of WT0TXT1 field. 

Area identifier of display area to which message is 
to be routed. 

Number of lines in the entire multiple-line WTO. 

Second line marker (contains zero). 

Length, in bytes, of WTOTXT2 + 4. 

Line type of WT0TXT2 field. 

Second line of text of the multiple-line WTO. 

Next line marker (contains zero). 

Length of WTOTXT3 field. 

Line type of WT0TXT3 field. 

Third line of text of the multiple-line WTO. 

Each subsequent entry in the parameter list will consist of a WTOMKn field, a WTOLNTn 
field, a WTOLTn field, and a WTOTXTn field. 
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INPUT TO WTQR MODULE 

Register 1 

WTORPRM, Address of WTOR Parameter List. 



WTQR Parameter List 



Offset 
(0) 


Bytes and 
Bit Pattern 
1 


Field 

Name 

WTORRPL 


1 


(1) 


3 




WTORRPA 


4 


(4) 


4 




WTORECB 


8 


(8) 


2 




WTORLNG 


10 


(A) 


2 

Byte 
0... 

1... 
.1.. 

..1. 
...1 

Byte 
1... 

.XXX 


0: 

1... 

.1.. 

..1. 
...1 

1: 

.1.. 

. .XX 


WTORMCS 


12 


(C) 


Variable 


WTORMSG 


n 




2 

Byte 
1... 

.1.. 
..1. 
...1 


0: 
1... 


WTORDSC 



n+1 



Byte 1 : 
. xxx xxxx 



Field Descriptions 

The length, in bytes, of the area to receive the 

reply. 

The address of the area for the reply. 

The address of the ECB to be posted by the control 
program when the reply is completed. 

The length, in bytes, of the WTOR message. 

MCS codes. 



The WTORDSC and WTORROU parameter fields do not 

exist. 

The WTORDSC and WTORROU parameter fields exist. 

The message is to be queued to the console whose 

source ID is passed in register 0. 

The WTOR is an immediate command response. 

Indicates that the WTORMGT parameter field exists. 

The WTO macro instruction is a reply to a WTOR macro 

instruction. 

This message should be broadcast to all active 

consoles. 

This message is to be queued for hard copy only. 

This message is to be queued unconditionally to the 

console whose source ID is passed in Register 0. 



Time is not appended to the message. 

Reserved. 

This message is not to be queued for hard copy (if it 

went to paper-producing, nongraphic device) . 

Reserved. 

Message to be written on operator's console. 

Descriptor codes . 



System Failure - another IPL of the system is 
required. 

Immediate operator action required. 
Eventual action required. 

System Status is indicated by the message. 
Immediate command response - for error and nonerror 
messages that are written as a result of an operator 
or system command. 

Job Status indicated by the message. 
Application Program/Processor - for messages issued 
by problem programs and processors executed as pro- 
blem programs. 
Operator request for status information. 



Out-of-line message. 
Reserved. 
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Bytes 


> and 


Field 


Offset 


Bit Pattern 


name 


n+2 


2 




WTORROU 




Byte 


0: 






1... 


• • • • 






.1.. 


• • • • 






..1. 


• • . • 






...1 


.... 






• • • • 


1... 






• • ■ ■ 


.1.. 






• • • • 


..1. 






.... 


...1 




n+3 


Byte 


1: 






1... 


• • • • 






.1.. 


• • • • 






..1. 


.... 






...1 


.... 






• • • • 


XXX. 
• • .X 




n+4 


1 




WTORMGT 




1... 
.1.. 


"..:: 






..1. 


xxxx 





Field Descriptions 
Routing codes. 



Master Console. 

Master Console Informational. 

Tape Pool Console. 

Direct Access Pool Console. 

Tape Library Pool Console. 

Disk Library Pool Console. 

Unit Record Pool Console. 

Teleprocessing Control. 



System Security. 

System Error/Maintenance. 

Programmer Information Console. 

Reserved. 

User Routing Codes. 

Reserved. 

Message Type Flags. 
Display Jobnames. 
Display Status. 
Monitor Active. 
Reserved. 



n+5 



Reserved. 
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INPUT TO XCTL MODULE 

Register 15 

XCTLPARM, Address of XCTL Parameter List, 



XCTL Parameter List 



Offset 
(0) 



(1) 



Bytes and 

Bit Pattern 

1 

0000 0000 

1000 0000 



Field 

Name 

XCTLFLG 



XCTLEP 



Field Description 

EP or EPLOC specified, 
DE form specified. 

For the EP or EPLOC forms, this field contains the 
address of a doubleword containing the entry point 
name of the called routine. For the DE form, this 
field contains the address of the DE list entry. 



(4) 



(5) 



0000 0000 
0000 0001 
0000 0010 



XCTLHI 



XCTLDCB 



No Hierarchy specified. 
Hierarchy specified. 
Hierarchy 1 specified. 

The address of the DCB. Zero indicates that a DCB 
was not specified. The Linklib or Joblib DCB will be 
used. 



Symbolic Entry Point Name 



Offset 
(0) 



Bytes and 
Bit Pattern 



Field 

Name 

XCTLNAM 



Field Description 

This field contains the entry point name of the 
called routine. If the name is less than eight 
characters in length r the field is padded with 
blanks. When EPLOC is specified, this field is set 
up by the user. When EP is specified, this field is 
generated by the macro. 
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ABEND ENTRY/EXIT TABLE (Part 1 of 2) 



| Module 


1 


Entries 


1 


Exits 


1 


Reason for Exit 


1 


L. 


1 






1 






1 




i 


r^ 


1 






1 






1 




1 


| ABENDO 




SLIH 






ABEND 


G 




Abnormal termination 




| IEANTMOO 




ABEND 


11 




SCHEDULER 




Job step normal termination, no WTORs outstanding 














ABEND 


11 




Normal end, WTOR purge needed or MCS in system 




L 


1 






i 


ABEND 


12 


1 


Subtask normal end, no WTOR purge needed 


_ j 


r 


1 






1 






1 




1 


| ABEND 1 




ABEND 







GRAPHICS 




GJP hook 




| IEANTM01 




ABEND 


G 




ASIR 1 




Valid STAE 














ABEND 


11 




Normal ABEND 




L 


i 






1 






i 




i 


r 


1 






1 






1 




1 


| ABEND 2 




ABEND 


11 




DAR 1 






System task or task in must complete status 




| IEANTM02 




ABEND 


G 




ABEND 
ABEND 


3 
9 




Normal ABEND 
Valid recursion 




1 


-+- 






1 






1 




■ 






1 






1 




1 


| ABEND 3 




ABEND 


2 




ABEND 


4 




Normal ABEND 




| IEANTM03 










ABEND 


J 








L _ 


1 






1 






1 




i 


r 


1 






1 






1 




\ 


| ABEND 4 




ABEND 


3 




ABEND 


5 




Full dump 




| IEANTM04 




ABEND 


9 




ABEND 


7 




Job step, no subtasks 








ABEND 


10 




ABEND 


8 




Job step, indicative dump 








ABEND 


H 




ABEND 


10 




Insufficient storage 








ABEND 


J 




ABEND 
ABEND 
ABEND 


12 
13 
15 




Job step with subtasks, ENQ purge needed 
Job step with subtasks, no ENQ purge needed 




L m „„ 


1 






1 






1 




i 


r 


1 






1 






1 




1 


I^ABEND 5 




ABEND 


4 




ABEND 


6 




SYSABEND or SYSUDUMP statement present in TIOT 




| IEANTM05 










ABEND 


9 




Failure in OPEN or dump 




L 


i 






I 






1 




i 


r 


1 






1 






1 




1 


| ABEND 6 




ABEND 


5 




ABEND 


7 




Job step with no subtasks 




| IEANTM06 










ABEND 
ABEND 
ABEND 
ABEND 


9 

12 
13 
15 




OPEN or dump failed 

Subtask ABEND, dump complete 

Job step with subtasks, ENQ purge needed 

Job step with subtasks, no ENQ purge needed 




J. 


-+- 






-+■ 






-+- 




-H 


| ABEND 7 




ABEND 


4 




SCHEDULER 








| IEANTM07 




ABEND 


6 




TCAM ABEND | 


Process TCAM abnormal termination 








ABEND 


8 


















ABEND 


15 


















TCAM 




















ABEND 














L 


-+- 






1 






1 




1 


r 






1 






1 




1 


| ABEND 8 




ABEND 


4 




ABEND 


7 




Job step with no subtasks 




| IEANTM08 










ABEND 
ABEND 


13 
15 




Job step with subtasks, ENQ purge needed 
Job step with subtasks, no ENQ purge needed 




L_ 


i 






I 






1 




1 


r 


1 






1 






1 




1 


| ABEND 9 




ABEND 


2 




ABEND 


4 




Valid recursion 




| IEANTM09 




ABEND 
ABEND 


5 
6 




ABEND 


H 








L 


~+- 






1 






I 




1 


r 






1 






1 




1 


| ABEND 10 




ABEND 


4 




ABEND 


4 




In all cases 




| IEANTMOA 





















J. X X X. 

I^-IEAMTMOS in MFT without subtasking. 



— 1 
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ABEND ENTRY/EXIT TABLE (Part 2 of 2) 



r r r 

| Module | Entries | Exits 



Reason for Exit 



I- 


H~ 






-+- 






-+- 






l^-ABEND 11 




ASIR 






ASIR 






ASIR was caller, WTOR purge done 




| IEANTMOB 




ABEND 







ABEND 







Jobstep normal end, WTOR purge done 




I 


i 


ABEND 


1 


I 


ABEND 
ABEND 


2 
12 


1 


Normal ABEND 

Subtask normal end, WTOR purge done 




r 


1 






1 






1 






| 2 ABEND 12 




ABEND 







ABEND 


13 




Subtask ABEND 




| IEANTMOC 
L 


l 


ABEND 
ABEND 
ABEND 


4 
6 
11 


1 






1 






r 




















| 2 ABEND 13 




ABEND 


4 




ABEND 


15 




Terminate subtasks 




| IEANTMOD 

L 




ABEND 
ABEND 
ABEND 


6 
8 
12 


1 






1 






r 






1 






1 






| 2 ABEND 14 




ABEND 


15 




SVC EXIT 








| IEANTMOB 

i ... . 


i 






I 






i 






r 


1 






1 






1 






| 2 ABEND 15 




ABEND 


4 




ABEND 


7 




Close data sets 




| IEAQTMOF 
L 


I 


ABEND 
ABEND 
ABEND 


6 
8 
13 


1 


ABEND 


14 


I 






r 


1 






1 






1 






| ABEND G 




ABEND 







SVC EXIT 








| IEANTMOG 




ABEND 


M 




ASIR 1 




STAE Exit routine entry 














DAR 1 






DAR Recursion 














DAR 2 






Invalid DAR recursion 














ABEND 


1 




Abnormal Termination processing 














ABEND 


2 




Valid CLOSE recursion after DAR 














ABEND 


M 




Message List processing 




|. 


-+- 






H- 






H- 






| ABEND H 




















| IEANTMOH 

L.„ .. , _ 


l 


ABEND 


9 


1 


ABEND 


4 


1 






r^ 


1 






1 






1 






| ABEND J 




















| IEANTMOJ 
L - 


i 


ABEND 


3 


1 


ABEND 


4 


1 






r 


1 






1 






1 






| ABEND M 




ABEND 


G 




ABEND 


G 








| IEANTMOM 

i, _. .,„....._ .. 


i 






1 






| 






r 




















l^-IEACTMOB 


in 


an MCS system. 










| 2 For MFT without subtasking, modules 12, 13 r 14 r and 15 are not included in 


the system. 
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ABDUMP ENTRY/EXIT TABLE 



Module 



SVC 
DUMP 1 
IEAAADOY 



j Entries 
-+- 



SVC 
DUMP 2 
IEAAADOZ 



SVC SLIH 
(expansion 
of SNAP) 



Exits 



SVC DUMP 1 



ABDUMP 1 
SVC DUMP 2 
EXIT 



I 
-+- 



Reason for Exit 



EXIT 



Call is not for SVC DUMP 
Dump is to tape 

Dump in progress; caller not in supervisor state; 
or after normal dump to non-tape device 



— H 



ABDUMP 1 
IEAMADOO 



SVC DUMP 1 



ABDUMP 2 



In all cases 



ABDUMP 2 
IEAAADOD 



ABDUMP 1 



ABDUMP 3 
ABDUMP 5 
ABDUMP 6 



Supervisor data is requested 
Save area trace requested 
Neither requested 



ABDUMP 3 
IEAAADOA 



ABDUMP 4 
IEAAAD01 



ABDUMP 2 



ABDUMP 3 



ABDUMP 4 

ABDUMP 5 
ABDUMP 6 



In all cases 






Save area trace requested 
No save area trace 



h 



ABDUMP 5 
IEAAAD02 






ABDUMP 6 
IEAAAD03 



ABDUMP 2 
ABDUMP 4 

ABDUMP 2 
ABDUMP 4 
ABDUMP5 



ABDUMP 6 

ABDUMP 7 
ABDUMP 8 
ABDUMP 13 
TCAM 
ABDUMP 1 



In all cases 

Trace table requested 

Trace table not requested 

GTF Trace Table to be formatted 

TCAM control program being dumped 






ABDUMP 7 
IEAAADOB 



ABDUMP 6 



ABDUMP 8 



In all cases 



ABDUMP 8 
IEAAAD04 



ABDUMP 6 
ABDUMP 7 



ABDUMP 9 



In all cases 



ABDUMP 9 
IEAAAD05 



ABDUMP 8 



ABDUMP 10 
ABDUMP 11 



Problem program storage requested 
Problem program storage not requested 



ABDUMP 10 
IEAAADOE 



ABDUMP 9 



ABDUMP 11 



In all cases 



ABDUMP 11 
IEAAADOC 



ABDUMP 9 
ABDUMP 10 



ABDUMP 12 



In all cases 



h 



ABDUMP 12 
IEAAADOF 

TCAM 

ABDUMP 1 
IEAAADOG 

TCAM 

ABDUMP 2 
IEAAAD0H 

TCAM 

ABDUMP 3 
IEAAADOI 



+ 



ABDUMP 11 



ABDUMP 6 



TCAM 
ABDUMP 1 



RETURN TO 
CALLER 

TCAM 
ABDUMP 2 

TCAM 
ABDUMP 3 



In all cases 



In all cases 



In all cases 






+ __ 



TCAM 
ABDUMP 2 



TCAM 
ABDUMP 4 



In all cases 



h 



TCAM 

ABDUMP 4 
IEAAADOJ 



TCAM 
ABDUMP 3 



ABDUMP 7 
ABDUMP 8 
ABDUMP 13 



Trace table requested 

Trace table not requested 

GTF Trace Table to be formatted 



ABDUMP 13 
IEAAADOK 



ABDUMP 6 
ABDUMP 14 
TCAM 
ABDUMP 4 



ABDUMP 8 
ABDUMP 14 



GTF trace table formatting completed 
Trace error or control record encountered 



ABDUMP 14 
IEAAADOM 



ABDUMP 13 



ABDUMP 13 



Trace error or control record processed 
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Task 
Supervision 



• ATTACH* 

• CHAP 

• DETACH 
e EXTRACT 

• WAIT 

• POST 

• ENQ 

• DEQ 

• SPIE 

• STAE 



il 



Contents 
Supervision 



• ATTACH 

• DELETE 
o LINK 

• LOAD 

• XCTL 

• FINCH 

• SYNCH 



2£ 



Main Storage 
Supervision 



• GETMAIN 

• FREEMAIN 




Termination 
Processing 



• ABEND 

• ABTERM 

• ABDUMP 

• DAR 

• ASIR 



Any 
Interruption 



Interruption 
Supervision 



Determine Type 
of Interruption 



I£ 



Communication 
Task 



• WTO/R 

• Console 
Switch 

• DOM 

• Device 
Processor 



I£ 




Timer 
Supervision 



.TIME 
. STIMER 
» TTIMER 



Overlay 
Supervision 



» SEGLD 

. SEGWT 

. ENTAB 

Branch 




Checkpoint/ 
Restart 



• CHKPT 

• Restart 



1£ 



Exiting and 
Dispatching 



• EOT 

• ETXR 

• Task Switch 




( Next Task J 



Diagram 01. The MFT Supervisor 
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Program A 









!■:- 




■ 








W'' • ' : :' :; ■'■■'■■ 


'::::■/; 


;■; 


;.;; ; 


- ':. 


'■'■ : ; 


■ 


- : 


! ; 




%:■ 




^ ■■■■ ■■■ 





















Old PSW 



New PSW 



X7 



Interruption Supervision 



T/E 
FLIH 



I/O 
FLIH 



Program 
FLIH 



7> 

I I 



SVC 
FLIH 



SVC 
SLIH 



EXIT 



Task Supervision 



Task Termination 



Contents Supervision 



Main Storage Supervision 



Timer Supervision 



Communications Task 



I/O Supervision 



Overlay Supervision 



Checkpoint/Restart 



7\ 



Isr' 



Program A 



Program n 



Dispatcher 



'::■■ 


[ 


[ - v 


■■ 


. 








:::; 


- 




:■■■.■ :-.■■■ 



Diagram 02. Interruption Supervision 
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Program A 



Program A 




|— -»»| Address of TCB 



Reg 5 

l—-*-l Address of RB 





NEW 


f 


IEATCBP 


Address of 
TCBn 






OLD 


f 


IEATCBP+4 


Address of 
TCBA 





// 

/ / 

/ 
/ 
/ 



Diagram 03. SVC FLIH and Type-1 Exit 
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Program A 


:. '■' 




'■■ ' '- : ' :■■■■■;: 






- 






J 



SVC FLIH 




SVC SLIH 



Save 


Obtain 


SVC 


Main 


Old 


Storage 


PSW 


for SVRB 


/ 






/ 






/ 






/ 






/ 







Storage 
Available? 



Z\ 



xz. 



GETMAIN 



Subtask 
Termination 



ABTERM 



Schedule 
ABEND 



TCBA 



/ 



RB Al f 



XRBPSW 



XRBLNK 



TCBRBP 



f Dl! 



Initialize 
SVRB and 
Put It on 
RB Queue 



Not Avail 



spatcher 



) 



Routine 
Resident? 



Load 

Parameter 

List 



Non- 
Resident 



rX™3 



7^ 



\Z 



SVC Routine 



Program Fetch 



LOAD 
Routine into 
XS NT Area 



k 



y 



\ 



X 



TCBA 



/ 



TCBRBP 


X 
X 


SVRB A2 


\ 

\ 








J 




*, 




XRBLNK 


/ 



\ 



y 



RB Al 



XRBPSW 



XRBLNK 



Diagram 04. SVC SLIH 
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Program A 



z\ 



EXIT 



From 
SVC 
SLIH 

SV03 



Save 
Regs 



User Error 
Routine 
Exit: Reset 
PSW from PIE 



SVC Old PSW 



/ 



/ 



/ 



Dequeue 

Program 

STAE 

Control 

Blocks 



If RB is an 
SIRB or an 
IRB, Dequeue 
top IQE 



If Not Last 
RB on Queue, 
Dequeue RB 



TCBis 
for Job 
Step Task 



TCB is for 
Subtask: 
Process Any 
Options 





Dispatcher J 





POST 


Post ECB 








TIMER DEQ 


Remove TQE 








Stage 2 
Exit Effector 




Schedule 
ETXR 



Diagram 05. EXIT 
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Program A 



External Old PSW 



7\ 



External New PSW 



Address of 
Program A NSI 



Iz 



Address of 
T/E FLIH 



/ 



/ 



T/E FLIH 



No Pseudo Disable 



Save External 
Old PSW in RB 



RBA1 



XRBPSW 



Save Regs, 
in TCB 



Pseudo Disable 



Save Old PSW 
and Regs, in 
CSECT Area 



\ / 

\ I 

\ I 

I I 

/ \ 

/ \ 



TCB A 



TCBGRS 



-L 



Determine 
Type of 
Interruption 



GTF 



Record 
Interrupt 



External 



Timer 



IEEBC1PE 



External SLIH 



IEA0TI00 



Timer SLIH 



Reset 

I/O 

Switch 



A 



Pseudo 
Disable 
is off 



Pseudo 
Disable 

"is on 



f Dispatcher ) 
See Figure 19 



(Entry from A 
I/O FLIH J 



From Figure 17 



Diagram 06. Timer/External FLIH 
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Program A 



J 7 i/o 



FLIH 



I/O Supervisor 
was Interrupted 



Indicate 
I/O FLIH 
in Process 



No Pseudo Disable 



Save I/O Old 
PSW in RB 



Save Regs, 
in TCB 



Pseudo Disable 



Save I/O Old 
PSW and Regs, 
in CSECT Area 



( I/O Supervisor J 



RB Al 



XRBPSW 



/ 



TCB A 



TCBGRS 



TRACE 



Record 
Interrupt 




\7 



I/O Supervisor 



Diagram 07. Input/Output FLIH 
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Program A 



Program New PSW 



Program Old PSW 



Address of 
Program Check 
FLIH 



Address of 
Program AT NSI 



\/ Program Check FLIH 



Interruption 

within 

Supervisor? 



/ 



Problem 
Program 
Has Not 
Issued SPIE 



Yes 



Save Regs 
and Program 
Old PSW 
in PIE 



\ 



Set Program 
Old PSW to 
User Error 
Handler 



GTF 



Record Monitor 
Call and Program 
Checks 



f ABTERM } \ 




T 



Set Return 
to Address 
of SVC 3 
Instruction 




Reg 14 



Address of 
SVC 3 



\ 



\ Program Old PSW 

\ 



Address of 
User Routine 



\z 



User Routine 



Process 

Program Check 
Interruption 



iBR 14 [ 



To EXIT 

See Figure 15 



Diagram 08. Program Check FLIH 
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Program A 




Diagram 09. Dispatcher 
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Program A 



ATTACH B 



SVC FL1H 



SVC SL1H 



ATTACH 



Obtain 
Main Storage 
for TCB and 
dummy PRB 



Process 
ECBor 
ETXR 
Parameters 




Set Limit 
and Dispatch 
Priorities of 
Subtask 



Initialize 
TCB and 
dummy 
PRB 



Put Subtask 
TCB on Queue 
and PRB 
on TCB 



iJ 



Set Resume 
PSW to address 
of LINK SVC 
inCVT 



GETMAIN 



TCB A 





\ 



/ 
Dummy PRB j 

/ 



XRBPSW 



\ 



1 



EXIT 



CVT 




Diagram 10. Attaching a Subtask (Part 1) 
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Subtask B 



Dispatcher 



Loads Resume 
PSW from Dummy 
PRB (SVC 6) 



EXIT 



Remove LINK 
SVRB from TCB 
RB Queue 




\ \ 

\| Dummy PRB \ 




TCBB 




•^^ LINK SVRB 




Subtask RB 



Diagram 11. Attaching a Subtask (Part 2) 
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Program A 

Limit Priority = 100 



ATTACH EP=PROGB, DPMOD=-10 



CHAP -15,'S' 



Dispatching 
Priority = 100 




Program A TCB 



34 35 



100 100 



TCBTCB 



Program C TCB 



34 35 



40 30 



TCBTCB 



To Program D TCB 




Program A TCB 



34 35 



| 100 1 100 



TCBTCB 



TCBLTC 



Program B TCB 



34 35 



100 90 



TCBTCB 



TCBOTC 



To Program C TCB 




Program B TCB 



34 35 



100 90 



TCBTCB 



TCBOTC 



Program A TCB 



34 35 
1 100 1 85~ 



TCBTCB 



TCBLTC 



To Program C TCB 



Diagram 12. Creating and Changing Dispatching Priorities 
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Program A 



jSTAE' 



SVC 
FLIH 



SVC 
SLIH 



TCB 



TCBNSTAE 



M 



STAE 



EXIT 



V 



Create 
and Queue 
SCB 



/ 



SCB 



4 Exit Rtn. 



I Parm List 



| User RB 



Z_ 



SVC 
FLIH 



SVC 
SLIH 



Z. 



ABENDO 



^ 



ASIR 



User Retry Routine 



S\ 



fNo Retry 



7\ 



\z 



Retry 
Requested 



STAE 

Exit 

Routine 



Diagram 13. Processing for a Task Asynchronous Exit 
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Interruption Supervision 



a 



External Interrupt! 



IEAQEX00 



)f I/O Interruption A 
\^ from Console J 



IEAAIO00- 



External FLIH 



Resident Communication Task 



IEAAIH00 



I/O FLIH 



I/O Supervisor 



IEECVCRX 



External (Post Com 
Task ECB) 



1 



l — 



IEA0DS 



•C 



Dispatcher 



lEECVCTWw 



IEECVCTI 



Initialization 
(Performed at NIP) 



> 



± 



IEECVCRA 



Attention (Post 
Com Task ECB) 



IEECIR45 



Wait Routine (Wait 
on ECBs in UCM) 



IEECVCM 



Unit Control 
Module 



Nonresident Communication Task (SVC 72) 



IEECVCTR 



Router 
T 



























' 


' 




< 


r 






' 




y 


IEECVCTX 




IEECVPMX 




IEECVPMC 




1EECVPMP 


External Interruption 
Processor 


1052 
Processor 


Unit Record 
Input Processor 


Unit Record 
Output Processor 














i 
i 




u 




IEECVOCX 




1 EEC VOCC 




IEECVOCP 




Open/Close 
Support 


Open/Close 
Support 


Open/Close 
Support 



Diagram 14. Console Communications without MCS: Input 



Method of Operation Diagrams 489 



Interruption Supervision I Communication Task 



c 



WTO or WTOR 
SVC 35 
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